Onboard a Customer

Walk through creating a verified Organization Customer.

1. Create the Customer

Call POST /customers with BVN, international phone, and email. Names come from the BVN identity fetch — do not send them yourself. The same organization plus BVN combination is idempotent.

curl https://api.aellaapp.com/customers \
  -X POST \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"bvn":"22122212221","phone":"+2348012345678","email":"john.doe@example.com"}'

Save data.id — later steps that need a Customer use this id.

2. Fetch the Customer

Call GET /customers/{customerId} when you need to confirm the stored profile. Response BVN is masked.

What's next

• Collect repeat payments with Collect Recurring Payments
• Full parameter tables on the Customers reference