Get Bank Transfer Instructions | Redpin

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

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](/api-guide/getting-started/authentication#oauth-20-authentication)

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.

Country code where the payment is being sent from. 3-letter ISO country code. See [ISO 3166-1 on Wikipedia](https://en.wikipedia.org/wiki/ISO_3166-1).

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.

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.

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

1	import requests
2
3	url = "https://sandbox.currenciesdirect.com/v3/customers/020123456789/payments/987654321/bank-transfer-instructions"
4
5	querystring = {"from_country":"GBR"}
6
7	headers = {"Authorization": "Bearer <token>"}
8
9	response = requests.get(url, headers=headers, params=querystring)
10
11	print(response.json())

1	{
2	"payment_method": "domestic_transfer",
3	"amount": {
4	"currency": "GBP",
5	"value": 1000.45
6	},
7	"account_details": {
8	"name": "Wattson",
9	"address": "Texas, Texas, Texas, 32323, USA"
10	},
11	"bank_details": {
12	"name": "JP Morgan Chase",
13	"address": "J.P. Morgan Florida 12345",
14	"routing_codes": [
15	{
16	"type": "ROUTING_EFT",
17	"value": "028000024",
18	"label": "EFT routing number"
19	},
20	{
21	"type": "ROUTING_WIRE",
22	"value": "021000021",
23	"label": "Wire routing number"
24	},
25	{
26	"type": "ACCOUNT_NUMBER",
27	"value": "20000023381857",
28	"label": "Account number"
29	},
30	{
31	"type": "ACCOUNT_TYPE",
32	"value": "checking",
33	"label": "Account type"
34	}
35	]
36	},
37	"payment_reference": {
38	"value": "ABCD123456",
39	"label": "Payment reference",
40	"disclaimer": "Always include this payment reference – it tells us the money has come from you."
41	}
42	}

Authentication

Path parameters

Query parameters

Response

Errors