curl --location '{{API_BASE_URL}}/transactions/TRF-7107555149278192088783030331355765593680-17261292800944/verify' \
--header 'x-giro-key: {{SECRET_KEY}}' \
--header 'Content-Type: application/json'

{
  "meta": {
    "statusCode": 200,
    "success": true
  },
  "data": {
    "_id": "66e2a48a7648f2b0f28e86742",
    "publicId": "trx-8d4332e00-fc44-4bfe-95a9-348a2r39d5888",
    "auth": "65b12bbf512f9932b67f53d7",
    "account": "65b12bbf36e38c6bfbe35f95",
    "deletedAt": null,
    "requestSrc": "api",
    "tags": [],
    "currency": "NGN",
    "entry": "debit",
    "destination": "bka-849sd4a45-c04c-4226-825a-12dff9c3fg40a9",
    "live": true,
    "destinationType": "BankAccount",
    "destinationData": {
      "id": 4353,
      "publicId": "bka-849sd4a45-c04c-4226-825a-12dff9c3fg40a9",
      "bankName": "Opay",
      "bankCode": "999992",
      "accountName": "Jane Doe",
      "accountNumber": "7086576668",
      "processor": "source",
      "clientIds": {},
      "nameEnquiryRef": "555558136afb46a6b6sde45a4653a4b3c3re384ccfb5a90131037"
    },
    "source": "vba-00228fe5c-aeff-45f5-a338-6b045545714b",
    "sourceType": "VirtualAccount",
    "sourceData": {
      "id": 113,
      "publicId": "vba-00228fe5c-aeff-45f5-a338-6b045545714b",
      "bankName": "Source MFB",
      "bankCode": "090641",
      "accountName": "Giro Expenses",
      "accountNumber": "6153332037",
      "currency": "NGN",
      "reference": null,
      "processor": "source"
    },
    "amount": 2000000,
    "balance": 5000000,
    "clientTransaction": {
      "fee": 2500,
      "actualAmount": 2002500
    },
    "fee": 2500,
    "feeReference": "fee-73887083e-c99b-42ee-85ec-4577998336454",
    "actualAmount": 2002500,
    "narration": "Expenses",
    "reference": "TRF-7107555149278192088783030331355765593680-17261292800944",
    "debitReference": null,
    "tRef": "GIR-6291285234044666400580911355723887500713-1726129289945",
    "linkRef": "TRFLNK-3205567866441776185720553998786846299624-1726129289944",
    "status": "success",
    "processor": "source",
    "meta": {
      "isThirdParty": true,
      "rate": {
        "rateId": 1,
        "rate": 1,
        "sourceCurrency": "NGN",
        "destinationCurrency": "NGN",
        "convertedAmount": 2000000
      },
      "credit": {
        "sourceType": "VirtualAccount",
        "sourceData": {
          "id": 113,
          "publicId": "vba-00228fe5c-aeff-45f5-a338-6b045545714b",
          "bankName": "Source MFB",
          "bankCode": "090641",
          "accountName": "Giro Expenses",
          "accountNumber": "6153332037",
          "currency": "NGN",
          "reference": null,
          "processor": "source"
        },
        "source": "vba-00b8fe5c-aeff-45f5-a338-6b082d35714b",
        "destination": "bka-84934a45-c08c-4426-825a-122f9c3f40a9",
        "destinationType": "BankAccount",
        "destinationData": {
          "id": 4353,
          "publicId": "bka-849sd4a45-c04c-4226-825a-12dff9c3fg40a9",
          "bankName": "Opay",
          "bankCode": "999992",
          "accountName": "Jane Doe",
          "accountNumber": "7086576668",
          "processor": "source",
          "clientIds": {}
        },
        "amount": 2000000,
        "currency": "NGN",
        "actualAmount": 2002500,
        "fee": 2500,
        "narration": "Expenses",
        "balance": 5000000
      },
      "verify": {
        "status": "success",
        "data": {
          "status": "success",
          "message": "request successful",
          "data": {
            "narration": "Expenses",
            "amount": 20000,
            "date": "2024-09-12T08:21:30.542Z",
            "beneficiary": {
              "accountNumber": "7086576668",
              "bankCode": "100004",
              "bankName": "Opay",
              "accountName": "Jane Doe"
            },
            "transactionStatus": "successful",
            "sessionId": "0906412409889921317200929291099",
            "type": "debit"
          }
        }
      }
    },
    "currencyPair": "NGN/NGN",
    "batchId": null,
    "updatedAt": "2024-09-12T08:25:00.610Z",
    "createdAt": "2024-09-12T08:21:29.945Z",
    "metadata": {}
  }
}

GET {{baseurl}}/transactions/{{reference}}/verify

   https://gw.stg.girostack.com/v1

Headers

x-giro-key
string
required

Pass your account’s secret key as the value.

Path Params

reference
string
required

This is your transaction’s reference.

curl --location '{{API_BASE_URL}}/transactions/TRF-7107555149278192088783030331355765593680-17261292800944/verify' \
--header 'x-giro-key: {{SECRET_KEY}}' \
--header 'Content-Type: application/json'

{
  "meta": {
    "statusCode": 200,
    "success": true
  },
  "data": {
    "_id": "66e2a48a7648f2b0f28e86742",
    "publicId": "trx-8d4332e00-fc44-4bfe-95a9-348a2r39d5888",
    "auth": "65b12bbf512f9932b67f53d7",
    "account": "65b12bbf36e38c6bfbe35f95",
    "deletedAt": null,
    "requestSrc": "api",
    "tags": [],
    "currency": "NGN",
    "entry": "debit",
    "destination": "bka-849sd4a45-c04c-4226-825a-12dff9c3fg40a9",
    "live": true,
    "destinationType": "BankAccount",
    "destinationData": {
      "id": 4353,
      "publicId": "bka-849sd4a45-c04c-4226-825a-12dff9c3fg40a9",
      "bankName": "Opay",
      "bankCode": "999992",
      "accountName": "Jane Doe",
      "accountNumber": "7086576668",
      "processor": "source",
      "clientIds": {},
      "nameEnquiryRef": "555558136afb46a6b6sde45a4653a4b3c3re384ccfb5a90131037"
    },
    "source": "vba-00228fe5c-aeff-45f5-a338-6b045545714b",
    "sourceType": "VirtualAccount",
    "sourceData": {
      "id": 113,
      "publicId": "vba-00228fe5c-aeff-45f5-a338-6b045545714b",
      "bankName": "Source MFB",
      "bankCode": "090641",
      "accountName": "Giro Expenses",
      "accountNumber": "6153332037",
      "currency": "NGN",
      "reference": null,
      "processor": "source"
    },
    "amount": 2000000,
    "balance": 5000000,
    "clientTransaction": {
      "fee": 2500,
      "actualAmount": 2002500
    },
    "fee": 2500,
    "feeReference": "fee-73887083e-c99b-42ee-85ec-4577998336454",
    "actualAmount": 2002500,
    "narration": "Expenses",
    "reference": "TRF-7107555149278192088783030331355765593680-17261292800944",
    "debitReference": null,
    "tRef": "GIR-6291285234044666400580911355723887500713-1726129289945",
    "linkRef": "TRFLNK-3205567866441776185720553998786846299624-1726129289944",
    "status": "success",
    "processor": "source",
    "meta": {
      "isThirdParty": true,
      "rate": {
        "rateId": 1,
        "rate": 1,
        "sourceCurrency": "NGN",
        "destinationCurrency": "NGN",
        "convertedAmount": 2000000
      },
      "credit": {
        "sourceType": "VirtualAccount",
        "sourceData": {
          "id": 113,
          "publicId": "vba-00228fe5c-aeff-45f5-a338-6b045545714b",
          "bankName": "Source MFB",
          "bankCode": "090641",
          "accountName": "Giro Expenses",
          "accountNumber": "6153332037",
          "currency": "NGN",
          "reference": null,
          "processor": "source"
        },
        "source": "vba-00b8fe5c-aeff-45f5-a338-6b082d35714b",
        "destination": "bka-84934a45-c08c-4426-825a-122f9c3f40a9",
        "destinationType": "BankAccount",
        "destinationData": {
          "id": 4353,
          "publicId": "bka-849sd4a45-c04c-4226-825a-12dff9c3fg40a9",
          "bankName": "Opay",
          "bankCode": "999992",
          "accountName": "Jane Doe",
          "accountNumber": "7086576668",
          "processor": "source",
          "clientIds": {}
        },
        "amount": 2000000,
        "currency": "NGN",
        "actualAmount": 2002500,
        "fee": 2500,
        "narration": "Expenses",
        "balance": 5000000
      },
      "verify": {
        "status": "success",
        "data": {
          "status": "success",
          "message": "request successful",
          "data": {
            "narration": "Expenses",
            "amount": 20000,
            "date": "2024-09-12T08:21:30.542Z",
            "beneficiary": {
              "accountNumber": "7086576668",
              "bankCode": "100004",
              "bankName": "Opay",
              "accountName": "Jane Doe"
            },
            "transactionStatus": "successful",
            "sessionId": "0906412409889921317200929291099",
            "type": "debit"
          }
        }
      }
    },
    "currencyPair": "NGN/NGN",
    "batchId": null,
    "updatedAt": "2024-09-12T08:25:00.610Z",
    "createdAt": "2024-09-12T08:21:29.945Z",
    "metadata": {}
  }
}