Validation
To check if a card is valid and get a token that can be used for later transactions, use this end point.
1 |
POST /api/v3/purchases/validations |
Sample Request
1 2 3 4 5 6 7 |
{ "transactionRef": "ESBDEV10004", // Unique transaction reference number. "authData":"Lisy0gf1qwSgAOR4xNS5jkiLFSh0C6dYqyzQhxopAVHaG0DqTaB8yHYGPfYBAg2ZShyGp2YJRzLsxpquvRuUZe6IO7h V+DDG1fsfx6bzLL7i6c/UFcw/T+QrsNOUgLjSqqlRNkMFmn1XN3CT0PtYEMwExE38cFHjZN8dX2xZOKhwFJ9CJOs2VXeXCvfExxyZ5k 3q+8dSxyHjYKrP3qfrjxhw7NFgEIvuo2xDlUTP6DLe8C/Z7QrBO3ggF7fo7Uz8t/vTcY7HvWmfX2UfiT7T5rzbOw24ahPZ8/tQg1dvp siO81Qaw/lS+8P+GigkNO5+GeTpRjo+CO+n656zrwU8MQ==" // Authentication Data. } |
Sample Response (success)
After card validation request has been sent, the expected successful validation response is similar to this.
1 2 3 4 5 |
{ "responseCode": "T0", // Response code. "transactionRef": "ESBDEV10004", // Unique transaction reference number. "message": "Kindly enter the OTP sent to 234812***8436 and dadub************itch.com" // Response message. } |
Sample Response (failure)
After card validation request has been sent, the expected validation failure response is similar to this, if any.
1 2 3 4 5 6 7 8 9 |
{ "errors": [ { "code": "E42", // Error code. "message": "Auth Data error" // Error message. } ], "transactionRef": "ESBDEV10004" // Unique transaction reference number. } |