curl --request POST https://api.acealliance.capital/imbank/v1/validate \
--header "Authorization: Bearer ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{ "customerRef": "1234567" }'
{
"resultCode": 0,
"message": "Customer found",
"customerName": "Daniel Kiptoo",
"customerRef": "1234567"
}
{
"resultCode": 1,
"message": "Customer not found",
"customerName": "",
"customerRef": ""
}
Endpoints
Validate a customer
POST
/
imbank
/
v1
/
validate
curl --request POST https://api.acealliance.capital/imbank/v1/validate \
--header "Authorization: Bearer ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{ "customerRef": "1234567" }'
{
"resultCode": 0,
"message": "Customer found",
"customerName": "Daniel Kiptoo",
"customerRef": "1234567"
}
{
"resultCode": 1,
"message": "Customer not found",
"customerName": "",
"customerRef": ""
}
Call before every payment.
A member who cannot receive a payment now can become valid later. Validate again on the next payment.
curl --request POST https://api.acealliance.capital/imbank/v1/validate \
--header "Authorization: Bearer ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{ "customerRef": "1234567" }'
{
"resultCode": 0,
"message": "Customer found",
"customerName": "Daniel Kiptoo",
"customerRef": "1234567"
}
{
"resultCode": 1,
"message": "Customer not found",
"customerName": "",
"customerRef": ""
}
Headers
string
required
Bearer ACCESS_TOKENstring
required
application/jsonRequest body
string
required
The Member Number. Seven digits. Surrounding spaces are ignored.
Response
integer
required
0 found, 1 not found.string
required
Customer found or Customer not found.string
required
The member’s full name. Empty when not found.
string
required
The Member Number without surrounding spaces. Empty when not found.
Errors
| Status | Meaning | Action |
|---|---|---|
404 | The reference names no member who can receive a payment now. | Hold the payment. |
401 | Token missing, expired, or not valid. No body. | Request a new token. |