POST /v1/customers Bearer Idempotent

Create customer

Create a customer record for dedicated static virtual accounts. merchant_reference is assigned by MojoPay (CUST-…); do not send it. Requires Static VA on your merchant.

Headers

Idempotency-Key required string: Required for money-moving and session/mandate creates; replays must use the same body.

Body parameters

name required string
email optional string (email)
mobile optional string: Digits only, 10–15 characters.
merchant_reference optional string: Prohibited — MojoPay assigns CUST-…. Do not send.

POST https://omni.mojo-pay.com/v1/customers

{
    "name": "Ama Customer",
    "email": "ama@example.com",
    "mobile": "233544338841"
}

curl -X POST "https://omni.mojo-pay.com/v1/customers" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ama Customer",
    "email": "ama@example.com",
    "mobile": "233544338841"
}'

Response

{
    "id": "MC_PAYMENTS01",
    "object": "customer",
    "merchant_reference": "CUST-A1B2C3D4E5",
    "name": "Ama Customer",
    "email": "ama@example.com",
    "mobile": "233544338841",
    "created_at": "2026-04-15T10:00:00+00:00"
}