v1

latestOpenAPI 3.1.02026-07-26540161.7 KB

Verify Payment

This API lets you verify the status of the transaction on the checkout API

get/checkout/payments/merchant-reference/{reference}

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

statusboolean
messagestring

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"
    }
  }
}