Payment on Terminal
Retrieve a payment
Balance
Webhooks
Payments
- GETRetrieve a PaymentIntent collection
- POSTCreate a PaymentIntent object
- GETRetrieve a PaymentIntent object
- POSTAttempt a payment on a PaymentIntent object
- POSTSynchronously attempt a payment on a payment intent
- POSTAuthenticate the current payment
- GETRetrieve fees
- GETRetrieve configured URLs
- GETRetrieve a PaymentIntent status
- GETRetrieve a Payments collection
- GETRetrieve the status payment object
Provisioning
Payment on Terminal
Transfers
Compliance
Payment on Terminal
Retrieve a payment
GET
/
terminal
/
payments
/
{id}
{
"id": "pi_z1urYtVFgEebtcj8fxp4v",
"merchantId": "<string>",
"createdAt": "2020-10-15T12:09:49.355Z",
"updatedAt": "2020-10-15T12:16:26.128Z",
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtZXJjaGFudElkIjoiMTYiLCJtb2RlIjoic2FuZGJveCIsInBheW1lbnRJZCI6InBpX3oxdXJZdFZGZ0VlYnRjajhmeHA0diIsImlhdCI6MTYwMjc1OTE4M30.OZ0fDnMVWvcT-gRthyBD58PFC20gabGKt1UPRe4aNi4",
"purchaseReference": "ref_2020_11_10_001",
"customerReference": "cust_01924059",
"status": "successful",
"amount": 100,
"currency": "XOF",
"payments": [
{
"id": "pay_QW2d6JnqiatcH8KhK0mD1",
"intentId": "pi_z1urYtVFgEebtcj8fxp4v",
"createdAt": "2020-10-15T12:09:49.355Z",
"updatedAt": "2020-10-15T12:16:26.128Z",
"status": "successful",
"amount": 100,
"currency": "XOF",
"method": "credit_card",
"country": "CI",
"failure": {
"code": "internal_error",
"message": "<string>",
"params": [
"<string>"
]
},
"fees": [
{
"id": "lAe5HnFpvOjwdT9vSIgPA",
"rate": 123,
"rateType": "percent",
"amount": 5,
"currency": "XOF",
"label": "<string>",
"taxes": [
"<string>"
]
}
],
"nextAction": {
"type": "ussd",
"message": "<string>",
"data": {
"url": "<string>",
"urls": "<string>",
"method": "post",
"headers": {},
"data": {}
}
},
"providerReference": "<string>",
"gatewayId": "<string>",
"number": "<string>",
"onSuccessRedirectionUrl": "https://my.website.com/cancel",
"onFailedRedirectionUrl": "https://my.website.com/finish",
"billing": {}
}
],
"mode": "live",
"nextAction": {
"type": "ussd",
"message": "<string>",
"data": {
"url": "<string>",
"urls": "<string>",
"method": "post",
"headers": {},
"data": {}
}
},
"lastPaymentFailure": {
"code": "internal_error",
"message": "<string>",
"params": [
"<string>"
]
},
"overrideBusinessName": "MyBusiness"
}
Headers
Your api key. To create a key, please get into our dashboard. If you don't have access to it, please reach the Support team.
Your merchant ID. This information is available in our dashboard. If you don't have access to it, please reach the Support team.
Allow you to choose between the sandbox mode to perform some tests or the live mode for real world transactions.
Available options:
live
, sandbox
Path Parameters
Identifier of the payment intent to retrieve.
Response
200
application/json
The response is of type object
.
{
"id": "pi_z1urYtVFgEebtcj8fxp4v",
"merchantId": "<string>",
"createdAt": "2020-10-15T12:09:49.355Z",
"updatedAt": "2020-10-15T12:16:26.128Z",
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtZXJjaGFudElkIjoiMTYiLCJtb2RlIjoic2FuZGJveCIsInBheW1lbnRJZCI6InBpX3oxdXJZdFZGZ0VlYnRjajhmeHA0diIsImlhdCI6MTYwMjc1OTE4M30.OZ0fDnMVWvcT-gRthyBD58PFC20gabGKt1UPRe4aNi4",
"purchaseReference": "ref_2020_11_10_001",
"customerReference": "cust_01924059",
"status": "successful",
"amount": 100,
"currency": "XOF",
"payments": [
{
"id": "pay_QW2d6JnqiatcH8KhK0mD1",
"intentId": "pi_z1urYtVFgEebtcj8fxp4v",
"createdAt": "2020-10-15T12:09:49.355Z",
"updatedAt": "2020-10-15T12:16:26.128Z",
"status": "successful",
"amount": 100,
"currency": "XOF",
"method": "credit_card",
"country": "CI",
"failure": {
"code": "internal_error",
"message": "<string>",
"params": [
"<string>"
]
},
"fees": [
{
"id": "lAe5HnFpvOjwdT9vSIgPA",
"rate": 123,
"rateType": "percent",
"amount": 5,
"currency": "XOF",
"label": "<string>",
"taxes": [
"<string>"
]
}
],
"nextAction": {
"type": "ussd",
"message": "<string>",
"data": {
"url": "<string>",
"urls": "<string>",
"method": "post",
"headers": {},
"data": {}
}
},
"providerReference": "<string>",
"gatewayId": "<string>",
"number": "<string>",
"onSuccessRedirectionUrl": "https://my.website.com/cancel",
"onFailedRedirectionUrl": "https://my.website.com/finish",
"billing": {}
}
],
"mode": "live",
"nextAction": {
"type": "ussd",
"message": "<string>",
"data": {
"url": "<string>",
"urls": "<string>",
"method": "post",
"headers": {},
"data": {}
}
},
"lastPaymentFailure": {
"code": "internal_error",
"message": "<string>",
"params": [
"<string>"
]
},
"overrideBusinessName": "MyBusiness"
}