Retrieve funding instructions for a customer cash balance. If funding instructions do not yet exist for the customer, new funding instructions will be created. If funding instructions have already been created for a given customer, the same funding instructions will be retrieved. In other words, we will return the same funding instructions each time.
Parameters
- bank_
transferobjectRequired Additional parameters for
bank_
funding typestransfer - bank_transfer.
typeenumRequired The type of the
bank_
transfer Possible enum valueseu_
bank_ transfer A bank transfer to a
eu_
bank_ transfer gb_
bank_ transfer A bank transfer to a
gb_
bank_ transfer jp_
bank_ transfer A bank transfer to a
jp_
bank_ transfer mx_
bank_ transfer A bank transfer to a
mx_
bank_ transfer us_
bank_ transfer A bank transfer to a
us_
bank_ transfer - bank_transfer.
eu_ bank_ transferobject Configuration for eu_bank_transfer funding type.
- bank_transfer.
eu_bank_transfer. countrystringRequired The desired country code of the bank account information. Permitted values include:
BE
,DE
,ES
,FR
,IE
, orNL
.
- bank_transfer.
requested_ address_ typesarray of enums List of address types that should be returned in the financial_addresses response. If not specified, all valid types will be returned.
Permitted values include:
sort_
,code zengin
,iban
, orspei
.Possible enum valuesiban
An IBAN financial address
sort_
code A SortCode financial address
spei
A Spei financial address
zengin
A Zengin financial address
- currencyenumRequired
Three-letter ISO currency code, in lowercase. Must be a supported currency.
- funding_
typeenumRequired The
funding_
to get the instructions for.type Possible enum valuesbank_
transfer Use a bank_transfer hash to define the bank transfer type
Returns
Returns funding instructions for a customer cash balance
{ "object": "funding_instructions", "bank_transfer": { "country": "DE", "financial_addresses": [ { "iban": { "account_holder_address": { "city": "Dublin", "country": "IE", "line1": "Some address", "line2": null, "postal_code": "D01H104", "state": "Dublin 1" }, "account_holder_name": "Merchant name", "bank_address": { "city": "Dublin", "country": "IE", "line1": "1 North Wall Quay", "line2": null, "postal_code": "D01 T8Y1", "state": "Dublin" }, "bic": "SOGEDEFFXXX", "country": "DE", "iban": "DE006847740991234567890" }, "supported_networks": [ "sepa", "swift" ], "type": "iban" } ], "type": "eu_bank_transfer" }, "currency": "eur", "funding_type": "bank_transfer", "livemode": false}