Funding Instructions

Funding Instructions contain reusable bank account and routing information. Push funds to these addresses via bank transfer to top up Issuing Balances.

Was this section helpful? Yes No

Create funding instructions

POST / v1 / issuing / funding_instructions

List all funding instructions

GET / v1 / issuing / funding_instructions

Simulate a top up

POST / v1 / test_helpers / issuing / fund_balance

The Funding Instruction object

Attributes

• bank _ transfer object Details to display instructions for initiating a bank transfer
• currency string Three-letter ISO currency code, in lowercase. Must be a supported currency.
• funding _ type enum The funding_type of the returned instructions Possible enum values bank_transfer Use a bank_transfer hash to define the bank transfer type

More attributes

• object string, value is "funding_instructions"
• livemode boolean

The Funding Instruction object

{ "object": "funding_instructions", "bank_transfer": { "country": "DE", "financial_addresses": [ { "iban": { "account_holder_name": "Stripe Technology Europe Limited", "bic": "SXPYDEHH", "country": "DE", "iban": "DE00000000000000000001" }, "supported_networks": [ "sepa" ], "type": "iban" } ], "type": "eu_bank_transfer" }, "currency": "eur", "funding_type": "bank_transfer", "livemode": false}

Create funding instructions

POST / v1 / issuing / funding_instructions

Create or retrieve funding instructions for an Issuing balance. If funding instructions don’t yet exist for the account, we’ll create new funding instructions. If we’ve already created funding instructions for the account, we’ll retrieve the same funding instructions. In other words, we’ll return the same funding instructions each time.

Parameters

• bank _ transfer object Required Additional parameters for bank_transfer funding types
• currency enum Required Three-letter ISO currency code, in lowercase. Must be a supported currency.
• funding _ type enum Required The funding_type to get the instructions for. Possible enum values bank_transfer Use a bank_transfer hash to define the bank transfer type

Returns

Returns funding instructions for an Issuing balance

cURL

Response

{ "object": "funding_instructions", "bank_transfer": { "country": "DE", "financial_addresses": [ { "iban": { "account_holder_name": "Stripe Technology Europe Limited", "bic": "SXPYDEHH", "country": "DE", "iban": "DE00000000000000000001" }, "supported_networks": [ "sepa" ], "type": "iban" } ], "type": "eu_bank_transfer" }, "currency": "eur", "funding_type": "bank_transfer", "livemode": false}