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 valuesibanAn IBAN financial address
sort_code A SortCode financial address
speiA Spei financial address
zenginA 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}