Create an OutboundPaymentQuote object v2

Money Management

Outbound Payment Quotes

Create an OutboundPaymentQuote object

Creates an OutboundPaymentQuote usable in an OutboundPayment.

Learn more about calling API v2 endpoints.

Parameters

amountobjectRequired
The “presentment amount” to be sent to the recipient.
- amount.currencystringRequired
  A lowercase alpha3 currency code like “usd”.
- amount.valueintegerRequired
  In minor units like 123 for 1.23 USD.

fromobjectRequired
Request details about the sender of an OutboundPaymentQuote.
- from.currencystringRequired
  Describes the FinancialAccount’s currency drawn from.
- from.financial_accountstringRequired
  The FinancialAccount that funds were pulled from.

toobjectRequired
Request details about the recipient of an OutboundPaymentQuote.
- to.currencystring
  Describes the currency to send to the recipient. If included, this currency must match a currency supported by the destination. Can be omitted in the following cases:
  destination only supports one currency
  destination supports multiple currencies and one of the currencies matches the FA currency
  destination supports multiple currencies and one of the currencies matches the presentment currency Note - when both FA currency and presentment currency are supported, we pick the FA currency to minimize FX.
- to.payout_methodstring
  The payout method which the OutboundPayment uses to send payout.
- to.recipientstringRequired
  To which account the OutboundPayment is sent.

delivery_optionsobject
Method to be used to send the OutboundPayment.
- delivery_options.bank_accountenum
  Method for bank account.
  Possible enum values
  automatic
  Method automatically selected by Stripe.
  local
  The group of local bank-transfer networks in the bank account’s country.
  wire
  The group of wire transfer networks in the bank account’s country.

Returns

Response attributes

idstring
Unique identifier for the OutboundPaymentQuote.

objectstring, value is "v2.money_management.outbound_payment_quote"
String representing the object’s type. Objects of the same type share the same value of the object field.

amountobject
The “presentment amount” for the OutboundPaymentQuote.
- amount.currencystring
  A lowercase alpha3 currency code like “usd”.
- amount.valueinteger
  In minor units like 123 for 1.23 USD.

createdtimestamp
Time at which the OutboundPaymentQuote was created. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.

delivery_optionsnullable object
Delivery options to be used to send the OutboundPayment.
- delivery_options.bank_accountnullable enum
  Method for bank account.
  Possible enum values
  automatic
  Method automatically selected by Stripe.
  local
  The group of local bank-transfer networks in the bank account’s country.
  wire
  The group of wire transfer networks in the bank account’s country.

estimated_feesarray of objects
The estimated fees for the OutboundPaymentQuote.
- estimated_fees.amountobject
  The fee amount for corresponding fee type.
  estimated_fees.amount.currencystring
  A lowercase alpha3 currency code like “usd”.
  estimated_fees.amount.valueinteger
  In minor units like 123 for 1.23 USD.
- estimated_fees.typeenum
  The fee type.
  Possible enum values
  cross_border_fee
  The cross border fee.
  fx_fee
  The FX fee.
  payout_fee
  The payout fee.

fromobject
Details about the sender of an OutboundPaymentQuote.
- from.debitedobject
  The monetary amount debited from the sender, only set on responses.
  from.debited.currencystring
  A lowercase alpha3 currency code like “usd”.
  from.debited.valueinteger
  In minor units like 123 for 1.23 USD.
- from.financial_accountstring
  The FinancialAccount that funds were pulled from.

fx_quoteobject
The underlying FXQuote details for the OutboundPaymentQuote.
- fx_quote.ratesmap
  Key pair: from currency Value: exchange rate going from_currency -> to_currency.
- fx_quote.to_currencystring
  The currency that the transaction is exchanging to.

livemodeboolean
Has the value true if the object exists in live mode or the value false if the object exists in test mode.

toobject
Details about the recipient of an OutboundPaymentQuote.
- to.creditedobject
  The monetary amount being credited to the destination.
  to.credited.currencystring
  A lowercase alpha3 currency code like “usd”.
  to.credited.valueinteger
  In minor units like 123 for 1.23 USD.
- to.payout_methodstring
  The payout method which the OutboundPayment uses to send payout.
- to.recipientstring
  To which account the OutboundPayment is sent.

Error Codes

400outbound_payment_default_payout_method_config_not_found

Error returned when a payout method is not provided in the OutboundPayment request and the recipient account does not have a default payout method.

404not_found

The resource wasn’t found.

404outbound_payment_from_financial_account_not_found

Error returned when financial account in the OutboundPayment request cannot be identified.

404outbound_payment_invalid_payout_method

Error returned when the payout method in the OutboundPayment request cannot be identified.

404outbound_payment_to_recipient_not_found

Error returned when the recipient account in the OutboundPayment request cannot be identified.

POST /v2/money_management/outbound_payment_quotes

curl -X POST https://api.stripe.com/v2/money_management/outbound_payment_quotes \
  -H "Authorization: Bearer sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2" \
  -H "Stripe-Version: 2025-03-31.preview" \
  --json '{
    "from": {
        "financial_account": "fa_test_65R6SO61eK9ThYXegpO16R6SM1DrE9cwLCbFmOzpO7E2Fk",
        "currency": "gbp"
    },
    "to": {
        "recipient": "acct_test_61SGnR3uRIDJxlXGn66SGnR3E2SQicOtL82PNxQa8OUq",
        "payout_method": "frba_test_61SGnRTvcEWKPakGS16SGnR3E2SQicOtL82PNxQa8IKG",
        "currency": "eur"
    },
    "amount": {
        "value": 1000,
        "currency": "gbp"
    }
  }'

Response

{
  "id": "obpq_test_65SH4Ui1am0VPJsl9Ht16R6SM1DrE9cwLCbFmOzpO7ESO8",
  "object": "v2.money_management.outbound_payment_quote",
  "amount": {
    "value": 1000,
    "currency": "gbp"
  },
  "created": "2025-03-28T17:17:45.253Z",
  "delivery_options": null,
  "estimated_fees": [
    {
      "amount": {
        "value": 2,
        "currency": "gbp"
      },
      "type": "payout_fee"
    },
    {
      "amount": {
        "value": 3,
        "currency": "gbp"
      },
      "type": "cross_border_fee"
    },
    {
      "amount": {
        "value": 1.5,
        "currency": "gbp"
      },
      "type": "fx_fee"
    }
  ],
  "from": {
    "debited": {
      "value": 1000,
      "currency": "gbp"
    },
    "financial_account": "fa_test_65R6SO61eK9ThYXegpO16R6SM1DrE9cwLCbFmOzpO7E2Fk"
  },
  "fx_quote": {
    "rates": {
      "gbp": {
        "exchange_rate": "1.19599"
      }
    },
    "to_currency": "eur"
  },
  "to": {
    "credited": {
      "value": 1196,
      "currency": "eur"
    },
    "payout_method": "frba_test_61SGnRTvcEWKPakGS16SGnR3E2SQicOtL82PNxQa8IKG",
    "recipient": "acct_test_61SGnR3uRIDJxlXGn66SGnR3E2SQicOtL82PNxQa8OUq"
  }
}

Create an OutboundPaymentQuote object v2

Parameters

amountobjectRequired

amount.currencystringRequired

amount.valueintegerRequired

fromobjectRequired

from.currencystringRequired

from.financial_accountstringRequired

toobjectRequired

to.currencystring

to.payout_methodstring

to.recipientstringRequired

delivery_optionsobject

delivery_options.bank_accountenum

Returns

Response attributes

idstring

objectstring, value is "v2.money_management.outbound_payment_quote"

amountobject

amount.currencystring

amount.valueinteger

createdtimestamp

delivery_optionsnullable object

delivery_options.bank_accountnullable enum

estimated_feesarray of objects

estimated_fees.amountobject

estimated_fees.amount.currencystring

estimated_fees.amount.valueinteger

estimated_fees.typeenum

fromobject

from.debitedobject

from.debited.currencystring

from.debited.valueinteger

from.financial_accountstring

fx_quoteobject

fx_quote.ratesmap

fx_quote.to_currencystring

livemodeboolean

toobject

to.creditedobject

to.credited.currencystring

to.credited.valueinteger

to.payout_methodstring

to.recipientstring