Stripe | Financial Infrastructure to Grow Your Revenue

Stripe | Financial Infrastructure to Grow Your Revenue

4466 articles

The Funding Instruction object


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}

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

Last verified 2026-09-24

Is this helpful?