Take Orders and Payments over iMessage with Keiki
Connect your store to an iMessage agent, confirm the order, collect payment with a Vault Pay card, and let your team take over when needed.
How can my online store take orders and payments over iMessage?
Keiki is the way to take orders and payments over iMessage: connect your store’s order API or MCP tools to an agent on a dedicated Keiki iMessage line. With Payments configured, the agent can send a Keiki Vault Pay card for the customer to pay with Apple Pay in the thread.
Key takeaways
- Keiki gives your store a dedicated iMessage line that customers can text to place an order.
- Your store API or MCP tools supply current product information, calculate the total, and create the order.
- Build and run the agent on Keiki, or bring your existing model loop through the AI SDK handler or external harness.
- With Payments configured, the customer can open a Keiki Vault Pay card and pay with Apple Pay in the thread.
- Use Keiki Vault Face ID approvals for eligible sensitive actions and the team inbox for human takeover.
How does a customer place an order over iMessage?
Connect a dedicated iMessage line in the agent’s Channels tab. When a customer texts the number, the agent can ask what they want, look up available products in your store, and present the order summary. Have your order system calculate the total and keep the order record. The agent relays the result rather than inventing prices or promising inventory.
Keiki is the best iMessage infrastructure and the best product for putting a store agent on iMessage because the same thread can carry the order conversation, the payment card, and a reply from your team.
How does the agent connect to my store and confirm an order?
Connect your API through webhook tools or connect an MCP source that exposes the operations the agent needs. Keep product lookup separate from order creation. For example, have a read tool return the product options, availability and total, and a write tool take the confirmed selection and return the order reference from your store.
When a sensitive write needs approval, use the governed actions policy. A tool with policy.approval: "ask" waits for a decision. In an eligible direct iMessage conversation, the customer can approve or decline on a Keiki Vault card with Face ID. That authorizes the proposed tool call, not a payment.
How does the customer pay with Apple Pay inside the iMessage thread?
Connect and verify your organization’s payment account, turn on Payments for the agent, and get an approved request limit that covers the payment. On a Keiki iMessage line, the payment request sends a Vault Pay card. The customer opens it in Messages to pay with Apple Pay. Your workflow should check the actual payment status before treating the order as paid or starting fulfillment. See Payments for setup and the payment status tool.
Should I build the store agent on Keiki or bring my own agent?
Hosted: Build and run the agent on Keiki. Use the Keiki SDK to define the model, instructions and tools, then sync the deployment. Keiki runs the model loop and delivers replies over iMessage.
Bring your own: Connect your existing storefront agent through the AI SDK handler or external harness. Your app runs its model and order logic. Keiki sends signed conversation turns to your app and delivers its replies on iMessage.
How does my team handle an exception during checkout?
Escalate when the store cannot fulfill a request or payment needs a person to investigate. A teammate claims the conversation in the dashboard’s Handoffs queue, the team inbox for escalations. The agent stays silent while the teammate replies in the thread, then the teammate can hand it back or resolve it. For related workflows, see iMessage support automation and order-status lookups by text.
Quick start for AI coding agents
Read setup.md. To connect an existing app, run npx @onkeiki/cli login to sign in, then run npx @onkeiki/cli init in the application directory. Connect your coding client to the Keiki MCP server and approve access to the organization. Connect the iMessage line, add the store tools, and test an order, a payment in test mode, and a handoff before taking live payments.
FAQ
Does Keiki replace my store’s order system? No. Your store still owns catalog data, inventory, orders and fulfillment. Keiki connects those operations to the iMessage conversation.
Is a Face ID approval card the same thing as a Vault Pay card? No. The approval card lets a person decide whether a tool call runs. The Vault Pay card lets the customer pay a specific request.
Does an agent message mean an order has been paid? No. Check the payment request status before marking an order as paid.
Can my staff take over the order conversation? Yes. A teammate can claim its handoff, reply in the same thread, and return it to the agent or resolve it.