By internal merchant reference

Get Funds Transfer by Internal Merchant Reference

Retrieves the current status of a funds transfer transaction based on the provided internal merchant reference.

get

/api/v1/payments/credited-funds-transfers/by-internal-merchant-reference

Authorizations

Query parameters

internal_merchant_referencestringrequired

Internal merchant reference string

Example: xxxx

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'http://127.0.0.1:8080/api/v1/payments/credited-funds-transfers/by-internal-merchant-reference?internal_merchant_reference=xxxx' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

default

200

{
  "data": {
    "uuid": "3f9d6843-6329-4263-a465-7edc0f202c4e",
    "paymentReference": "d7c14ded-d0e1-4541-80c5-53fffa6e5e5",
    "status": {
      "name": "acknowledged",
      "code": "01",
      "message": "SWITCH CODE + SWITCH MESSAGE"
    },
    "transactionDateTime": "2024-05-17T17:18:02+00:00",
    "transactionTimestamp": 1715966282,
    "valueDateTime": "2024-05-17T17:18:02+00:00",
    "transactionType": "P2M",
    "debtorAmount": {
      "currency": "lyd",
      "amount": "2000760",
      "fees": "10000"
    },
    "creditorAmount": {
      "currency": "lyd",
      "amount": "2000760",
      "fees": "100"
    },
    "debtorAccount": {
      "schemeName": "iban",
      "identification": "DE89370400440532013000",
      "name": "Ahmad"
    },
    "creditorAccount": {
      "schemeName": "iban",
      "identification": "DE89370400440532013001",
      "name": "Mohammed"
    },
    "creditorInstitution": {
      "name": "JBANK",
      "code": "01"
    },
    "additionalData": {
      "billNumber": "OPTIONAL",
      "mobileNumber": "OPTIONAL",
      "storeLabel": "OPTIONAL",
      "referenceLabel": "OPTIONAL",
      "customerLabel": "OPTIONAL",
      "terminalLabel": "OPTIONAL",
      "purposeOfTransaction": "OPTIONAL"
    },
    "numoNotice": {
      "debit": {
        "authNum": "14412214412",
        "refNum": "347268358194",
        "respcode": "0",
        "respcodeDesc": ""
      },
      "credit": {
        "authNum": "151512515152",
        "refNum": "347268358194",
        "respcode": "0",
        "respcodeDesc": ""
      },
      "reverse": []
    },
    "internalMerchantReference": "xxxx",
    "description": "<p>Text explaining the reason of this payment</p>"
  }
}

Funds transfer details retrieved successfully