Get Bank Transfer Instructions | Redpin

{
  "payment_method": "domestic_transfer",
  "amount": {
    "currency": "GBP",
    "value": 1000.45
  },
  "account_details": {
    "name": "Wattson",
    "address": "Texas, Texas, Texas, 32323, USA"
  },
  "bank_details": {
    "name": "JP Morgan Chase",
    "address": "J.P. Morgan Florida 12345",
    "routing_codes": [
      {
        "type": "ROUTING_EFT",
        "value": "028000024",
        "label": "EFT routing number"
      },
      {
        "type": "ROUTING_WIRE",
        "value": "021000021",
        "label": "Wire routing number"
      },
      {
        "type": "ACCOUNT_NUMBER",
        "value": "20000023381857",
        "label": "Account number"
      },
      {
        "type": "ACCOUNT_TYPE",
        "value": "checking",
        "label": "Account type"
      }
    ]
  },
  "payment_reference": {
    "value": "ABCD123456",
    "label": "Payment reference",
    "disclaimer": "Always include this payment reference – it tells us the money has come from you."
  },
  "payment_scheme_note": "Please note: This account only accepts FPS, BACS and CHAPS payments. FPS payments are available for amounts up to £1 million."
}

Retrieve bank transfer instructions for a payment.

Requirements:

Payment must be created with Payment v3 API (not v1/v2)
Payment must use bank transfer method (not wallet-funded)

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 initiated the payment. This is the customer ID of the person or entity that created the payment transaction.

payment_idstringRequired

Unique identifier for a payment created using the Payment v3 API.

Query parameters

from_countrystringRequired

Country code where the payment is being sent from. 3-letter ISO country code. See ISO 3166-1 on Wikipedia.

Response

Successful response with bank transfer instructions

payment_methodenum

Indicates the type of transfer:

domestic_transfer: For transfers within the same country (e.g., EFT, Wire).
international_transfer: For cross-border transfers requiring SWIFT/IBAN.

Allowed values:

amountobject

The exact currency and amount that the third party must transfer to the bank details provided in this response. The third party should send amount.value in amount.currency to the specified bank account. Amount must be sent with 2 decimal precision.

Example: If amount shows {"currency": "GBP", "value": 1000.45}, the third party should transfer exactly £1,000.45 GBP to the bank account details provided.

Example: If amount shows {"currency": "GBP", "value": 1000.45} the third party should transfer exactly £1,000.45 GBP to the bank account details provided.

account_detailsobject

bank_detailsobject

payment_referenceobject

payment_scheme_notestringOptional

Guidance on which payment schemes the beneficiary account accepts. Varies by the from_country query parameter.

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

500

Internal Server Error