Skip to main content

Customers

Store customer information and payment methods for faster checkout and recurring payments.

Create a Customer​

curl -X POST https://api.ikawaari.com/v1/customers \
  -H "Authorization: Bearer ik_test_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Aminata Koné",
    "email": "aminata@example.com",
    "phone": "+2250700000000",
    "metadata": {
      "user_id": "usr_123"
    }
  }'

Customer Object​

{
  "id": "cus_abc123",
  "object": "customer",
  "name": "Aminata Koné",
  "email": "aminata@example.com",
  "phone": "+2250700000000",
  "currency": "XOF",
  "balance": 0,
  "created": 1708300800,
  "metadata": {
    "user_id": "usr_123"
  }
}

Use Cases​

  • Recurring payments — Attach a customer to subscriptions
  • Saved payment methods — Let customers pay faster on return visits
  • Customer portal — Let customers manage their own billing
  • Invoicing — Send invoices to stored customer details