Verify Payment
This API lets you verify the status of the transaction on the checkout API
get/checkout/payments/merchant-reference/{reference}
Request
- Base URLhttps://sandboxapi.fincra.com
- AuthAPI key in header api-key
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Path parameters
referencestring required
The unique reference for the transaction on your system. This is different from the reference Fincra generates for the transaction
Headers
x-business-idstring required
The unique Identifier of the parent business
Response
200
Example response
{
"status": true,
"message": "Payment details fetched",
"data": {
"id": 443787,
"businessId": "64f1c92jx9m89232d710",
"amount": 350,
"currency": "NGN",
"convertedAmount": 350,
"convertedCurrency": "NGN",
"paymentMethods": [
"card"
],
"defaultPaymentMethod": "bank_transfer",
"redirectUrl": "https://docs.fincra.com/docs/payin-webhook",
"settlementDestination": "wallet",
"feeBearer": "customer",
"reference": "fcr-p-700ju9sf",
"merchantReference": "001",
"status": "success",
"createdAt": "2023-10-27T11:25:23.701Z",
"updatedAt": "2023-10-27T11:27:42.000Z",
"customer": {
"name": "John Doe",
"email": "customer@theirmail.com"
},
"business": {
"settings": {
"feeBearer": "customer",
"settlementDestination": "wallet"
},
"status": "enabled",
"countryCallingCode": "+234",
"businessTag": 200168,
"isKYCApproved": true,
"_id": "64f1c92jx9m89232d710",
"name": "Fincra DevRel",
"businessType": "Fintech",
"website": "https://fincra.com",
"email": "devrel@fincra.com",
"country": "NG",
"mobile": "08100000000",
"businessKey": "B-BZCINUIDW8J",
"createdAt": "2023-09-01T11:24:29.387Z",
"updatedAt": "2023-10-27T04:51:29.072Z"
}
}
}Changes
No recorded changes to this operation across all 2 revisions of this API.