Pin Reset OTP Endpoint
Endpoint
PUT {scheme}://{host}:{port}/virtual-card/api/v1/cards/reset-pin-otp |
Request Type is application/json
Authorization: {passport generated bearer token}
Request Message description
| Field# | Field name | Data type | Max length | Required | Description |
|---|---|---|---|---|---|
| 1 | mobileNumber | String | 25 | Yes |
Sample Request
{
“mobileNumber” : “2348065186175”
}
Sample Success Response
{
“responseCode”: “00”,
“responseMessage”: “Successful”,
“data”:{
“transactionReference”: “6f162de4”
}
}
Sample Failed Response
{
“responseCode”: “W102”,
“responseMessage”: “Failed to complete request”,
“errors”: [
{
“fieldName”: null,
“code”: “10400”,
“message”: “Bad request Error 1: pan-> not a valid card number”
}
]
}
Pin Reset OTP Endpoint
Endpoint
PUT {scheme}://{host}:{port}/virtual-card/api/v1/cards/reset-pin-resend-otp |
Request Type is application/json
Authorization: {passport generated bearer token}
Request Message description
| Field# | Field name | Data type | Max length | Required | Description |
|---|---|---|---|---|---|
| 1 | mobileNumber | String | 25 | Yes | |
| 2 | transactionReference | String | Yes |
Sample Request
{
“mobileNumber” : “2348065186175”,
“transactionReference” : “6f162de4”
}
Sample Success Response
{
“responseCode”: “00”,
“responseMessage”: “Successful”,
“data”:{
“transactionReference”: “6f162de4”
}
}
Sample Failed Response
{
“responseCode”: “W102”,
“responseMessage”: “Failed to complete request”,
“errors”: [
{
“fieldName”: null,
“code”: “10400”,
“message”: “Bad request Error 1: pan-> not a valid card number”
}
]
}
Pin Reset Endpoint
Endpoint
PUT {scheme}://{host}:{port}/virtual-card/api/v1/cards/reset-pin |
Request Type is application/json
Authorization: {passport generated bearer token}
Request Message description
| Field# | Field name | Data type | Max length | Required | Description |
|---|---|---|---|---|---|
| 1 | mobileNumber | String | 25 | Yes | |
| 2 | transactionReference | String | Yes | ||
| 3 | newPin | String | Yes | ||
| 4 | otp | String | yes |
Plain Sample Request
{
“mobileNumber” : “2348065186175”,
“transactionReference” : “6f162de4”,
“newPin” : “1234”,
“otp” : “485320”
}
Encrypted Sample Request
{
“data”:”T4DZPBE42uzXl61K5fckw8b0ZrzR5+nvNLEaTA9jFptCBq0nNN1tCk7QzcgajBbad1/pbC8QUf7oYZ1rVqQ/Kghyi0aC5tIyL2h3ul/jiPyjEmb18I0xTSz3w==”
}
Sample Success Response
{
“responseCode”: “00”,
“responseMessage”: “Successful”,
“data”:{
“maskedPan”: “506321*********0545”
}
}
Sample Failed Response
{
“responseCode”: “W102”,
“responseMessage”: “Failed to complete request”,
“errors”: [
{
“fieldName”: null,
“code”: “10400”,
“message”: “Bad request Error 1: pan-> not a valid card number”
}
]
}