Get Payment Details | Redpin

import requests
url = "https://sandbox.currenciesdirect.com/v3/customers/cust_123456789/payments/5636191"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.json())

{
  "payment_id": "5636191",
  "instruction_number": "cust_123456789-000000009",
  "status": "FX_COMPLETED",
  "payouts": [
    {
      "amount": {
        "currency": "AED",
        "value": 107.56
      },
      "recipient_details": {
        "recipient_id": "rec_123456789",
        "payment_reference": "payment to Mashreq account1"
      },
      "status": "INITIATED",
      "payment_date": "2025-07-10"
    },
    {
      "amount": {
        "currency": "AED",
        "value": 100
      },
      "recipient_details": {
        "recipient_id": "rec_987654321",
        "payment_reference": "payment to Mashreq account2"
      },
      "status": "INITIATED",
      "payment_date": "2025-07-10"
    }
  ],
  "client_reference_id": "c2860379-c845-4f4e-9d2e-5b058e9114b9",
  "fx_conversion": {
    "selling_amount": {
      "currency": "GBP",
      "value": 43.24
    },
    "buying_amount": {
      "currency": "AED",
      "value": 207.56
    },
    "agreed_rate": 4.8794,
    "booking_datetime": "2025-07-07T13:02:46Z",
    "value_date": "2025-07-09",
    "status": "CLOSED"
  }
}

Retrieve details for a specific payment by payment_id for a given customer.

Authentication: Bearer token required

Authentication

AuthorizationBearer

OAuth 2.0 Bearer token authentication. This API uses OAuth 2.0 Client Credentials flow. Please refer to the Authentication section for detailed information on how to obtain and use your OAuth credentials.

Path parameters

customer_idstringRequired

Unique identifier for the customer who owns the payment.

payment_idstringRequired

Unique identifier for the payment.

Response

Successful response with payment details

payment_idstring

Unique identifier assigned by the API when the payment is created.

instruction_numberstring

Instruction number assigned by the API when the payment is created.

statusenum

Current status of the payment. Refer to the Payment Status Events section for more details about the statuses.

payoutslist of objects

client_reference_idstring or null

Client-provided reference ID for the payment while creating the payment.

fx_conversionobject or null

FX conversion details.

Important: This field is only present when currency conversion was performed (i.e., when quote_id was provided in the payment request).

Not present for same-currency payments (when source and destination currencies are the same and no quote_id was provided).

FX conversion details. **Important:** This field is only present when currency conversion was performed (i.e., when `quote_id` was provided in the payment request). **Not present for same-currency payments** (when source and destination currencies are the same and no `quote_id` was provided).

Authentication

Path parameters

Response

Errors