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_transferfunding types - currency enum Required Three-letter ISO currency code, in lowercase. Must be a supported currency.
- funding _ type enum Required The
funding_typeto get the instructions for. Possible enum valuesbank_transferUse 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}
List all funding instructions
GET / v1 / issuing / funding_instructions
Retrieve all applicable funding instructions for an Issuing balance.
Parameters
No parameters.
More parameters
- ending _ before string
- limit integer
- starting _ after string
Returns
Returns all funding instructions for an Issuing balance
cURL
Response
Simulate a top up Test helper
POST / v1 / test_helpers / issuing / fund_balance
Simulates an external bank transfer and adds funds to an Issuing balance. This method can only be called in test mode.
Parameters
- amount integer Required The amount to top up
- currency enum Required The currency to top up
Returns
Returns testmode 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}