Overview
Customers
Funding Sources
Card Programs
Cards
Accounts
Authorizations
Transactions
curl --request POST \
--url https://api.sandbox.sudo.cards/customers \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "individual",
"name": "<string>",
"phoneNumber": "<string>",
"status": "active",
"billingAddress": {
"line1": "<string>",
"city": "<string>",
"state": "<string>",
"postalCode": "<string>",
"country": "<string>",
"line2": "<string>"
},
"emailAddress": "<string>",
"individual": {
"firstName": "<string>",
"lastName": "<string>",
"dob": "<string>",
"otherNames": "<string>",
"identity": {
"type": "BVN",
"number": "<string>"
},
"documents": {
"idFrontUrl": "<string>",
"idBackUrl": "<string>",
"incorporationCertificateUrl": "<string>",
"addressVerificationUrl": "<string>"
}
},
"company": {
"name": "<string>",
"identity": {
"type": "BVN",
"number": "<string>"
},
"officer": {
"firstName": "<string>",
"lastName": "<string>",
"dob": "<string>",
"otherNames": "<string>",
"identity": {
"type": "BVN",
"number": "<string>"
},
"documents": {
"idFrontUrl": "<string>",
"idBackUrl": "<string>",
"incorporationCertificateUrl": "<string>",
"addressVerificationUrl": "<string>"
}
},
"documents": {
"idFrontUrl": "<string>",
"idBackUrl": "<string>",
"incorporationCertificateUrl": "<string>",
"addressVerificationUrl": "<string>"
}
}
}
'"{}"Create Customer
Creates a new customer.
curl --request POST \
--url https://api.sandbox.sudo.cards/customers \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "individual",
"name": "<string>",
"phoneNumber": "<string>",
"status": "active",
"billingAddress": {
"line1": "<string>",
"city": "<string>",
"state": "<string>",
"postalCode": "<string>",
"country": "<string>",
"line2": "<string>"
},
"emailAddress": "<string>",
"individual": {
"firstName": "<string>",
"lastName": "<string>",
"dob": "<string>",
"otherNames": "<string>",
"identity": {
"type": "BVN",
"number": "<string>"
},
"documents": {
"idFrontUrl": "<string>",
"idBackUrl": "<string>",
"incorporationCertificateUrl": "<string>",
"addressVerificationUrl": "<string>"
}
},
"company": {
"name": "<string>",
"identity": {
"type": "BVN",
"number": "<string>"
},
"officer": {
"firstName": "<string>",
"lastName": "<string>",
"dob": "<string>",
"otherNames": "<string>",
"identity": {
"type": "BVN",
"number": "<string>"
},
"documents": {
"idFrontUrl": "<string>",
"idBackUrl": "<string>",
"incorporationCertificateUrl": "<string>",
"addressVerificationUrl": "<string>"
}
},
"documents": {
"idFrontUrl": "<string>",
"idBackUrl": "<string>",
"incorporationCertificateUrl": "<string>",
"addressVerificationUrl": "<string>"
}
}
}
'"{}"Authorizations
Body
This is the customer type.
individual, company The customer's full name.
Customer's mobile phone number in international format.
This is the initial status of the customer.
active, inactive This is the billing address
Customer's email address.
Individual details. Required if customer type is individual.
Show child attributes
Show child attributes
Customer's first name.
Customer's last name.
Customer's date of birth in the format YYYY/MM/DD.
Customer's other names.
Customer's KYC documents.
Show child attributes
Show child attributes
ID Card front page url.
ID Card back page url.
Company incorporation certificate url.
Customer address verification document url.
Company details. Required if customer type is company.
Show child attributes
Show child attributes
Company name.
Company officer information.
Show child attributes
Show child attributes
Customer's first name.
Customer's last name.
Customer's date of birth in the format YYYY/MM/DD.
Customer's other names.
Customer's KYC documents.
Show child attributes
Show child attributes
ID Card front page url.
ID Card back page url.
Company incorporation certificate url.
Customer address verification document url.
Customer's KYC documents.
Show child attributes
Show child attributes
Response
200
The response is of type object.