OutboundPayment represents a single money movement from one FinancialAccount you own to a payout method someone else owns.
Attributes
- idstring
Unique identifier for the OutboundPayment.
- objectstring, value is "v2.money_management.outbound_payment"
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 OutboundPayment.
- cancelableboolean
Returns true if the OutboundPayment can be canceled, and false otherwise.
- createdtimestamp
Time at which the OutboundPayment 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.
- descriptionnullable string
An arbitrary string attached to the OutboundPayment. Often useful for displaying to users.
- expected_
arrival_ datenullable timestamp The date when funds are expected to arrive in the payout method. This field is not set if the payout method is in a
failed
,canceled
, orreturned
state. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z. - fromobject
The FinancialAccount that funds were pulled from.
- livemodeboolean
Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - metadatanullable map
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- outbound_
payment_ quotenullable stringPreview feature The quote for this OutboundPayment. Only required for countries with regulatory mandates to display fee estimates before OutboundPayment creation.
- receipt_
urlnullable string A link to the Stripe-hosted receipt for this OutboundPayment. The receipt link remains active for 60 days from the OutboundPayment creation date. After this period, the link will expire and the receipt url value will be null.
- recipient_
notificationobject Details about the OutboundPayment notification settings for recipient.
- statement_
descriptorstring The description that appears on the receiving end for an OutboundPayment (for example, bank statement for external bank transfer).
- statusenum
Current status of the OutboundPayment:
processing
,failed
,posted
,returned
,canceled
. An OutboundPayment isprocessing
if it has been created and is processing. The status changes toposted
once the OutboundPayment has been “confirmed” and funds have left the account, or tofailed
orcanceled
. If an OutboundPayment fails to arrive at its payout method, its status will change toreturned
.Possible enum valuescanceled
A user canceled the OutboundPayment before posting. Stripe returns the funds to the user by voiding the pending Transaction.
failed
The OutboundPayment failed to confirm. Stripe returns the funds to the user by voiding the pending Transaction.
posted
The OutboundPayment posted and funds have left the account. The underlying Transaction posts.
processing
The OutboundPayment starting state. Funds are “held” by a pending Transaction (but are still part of the current balance). The OutboundPayment might be cancelable by the user, depending on the value of the cancelable field.
returned
The OutboundPayment failed to successfully arrive at the destination. Funds return to the user with a second posted Transaction attached to the same flow.
- status_
detailsnullable object Status details for an OutboundPayment in a
failed
orreturned
state. - status_
transitionsnullable object Hash containing timestamps of when the object transitioned to a particular status.
- toobject
To which payout method the OutboundPayment was sent.
- trace_
idobjectPreview feature A unique identifier that can be used to track this OutboundPayment with recipient bank. Banks might call this a “reference number” or something similar.
{ "id": "obp_test_65OAfT9tVl3u223h0he16NybHIZ4SQ3LORe4rpuNGDIKCO", "object": "v2.money_management.outbound_payment", "from": { "financial_account": "fa_test_65NybHaQx7KJxDc22rZ16NybHIZ4SQ3LORe4rpuNGDIXEO", "debited": { "value": 1000, "currency": "usd" } }, "to": { "credited": { "value": 1000, "currency": "usd" }, "recipient": "acct_test_61Nyc6oHjbwlpjhvd66Nyc6oZ4SQv89ZZAqvHiCECJ3g", "payout_method": "usba_test_61Nyd9YFBVUzLyxXZ16Nyc6oZ4SQv89ZZAqvHiCEC9VQ" }, "delivery_options": { "bank_account": "automatic" }, "amount": { "value": 1000, "currency": "usd" }, "statement_descriptor": "Payment for streaming earnings", "cancelable": true, "description": "Streamer earnings", "status": "processing", "status_transitions": {}, "receipt_url": "https://payments.stripe.com/transaction_receipt/CCMaIwohd2tzcF90ZXN0XzZOeWJISVo0U1EzTE9SZTRycHVOR0RJKMPgpqIGMgbztcBwNg46oQGUmYI69-O84chYtSQDFeO22gsaZPBsi9OkhxmOvY_z5ElXLqPGy_WUkLZ0XuCmjerVOR-ZnrOKDcHldqWvsxHXRaRnjq2SLu5V7tJaYWNe3_Vy2VhWmJ8H09qAOl8HxjS9prFckpisbEa_1u53hKgIXZVoI4FEOVWgFcf0-d7ev6zL728kPw-QcXbRkPi-wwaIXwxRNbyTpsBi6KzQ7PTqlg", "created": "2023-04-26T23:12:35.952Z", "expected_arrival_date": "2023-04-28T00:00:00Z", "recipient_notification": { "setting": "configured" }, "trace_id": { "status": "pending", "value": "" }, "outbound_payment_quote": null}
Creates an OutboundPayment.
Parameters
- amountobjectRequired
The “presentment amount” to be sent to the recipient.
- fromobjectRequired
From which FinancialAccount and BalanceType to pull funds from.
- toobjectRequired
To which payout method to send the OutboundPayment.
- delivery_
optionsobject Delivery options to be used to send the OutboundPayment.
- descriptionstring
An arbitrary string attached to the OutboundPayment. Often useful for displaying to users.
- metadatamap
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- outbound_
payment_ quotestringPreview feature The quote for this OutboundPayment. Only required for countries with regulatory mandates to display fee estimates before OutboundPayment creation.
- recipient_
notificationobject Details about the notification settings for the OutboundPayment recipient.
Returns
Response attributes
- idstring
Unique identifier for the OutboundPayment.
- objectstring, value is "v2.money_management.outbound_payment"
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 OutboundPayment.
- cancelableboolean
Returns true if the OutboundPayment can be canceled, and false otherwise.
- createdtimestamp
Time at which the OutboundPayment 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.
- descriptionnullable string
An arbitrary string attached to the OutboundPayment. Often useful for displaying to users.
- expected_
arrival_ datenullable timestamp The date when funds are expected to arrive in the payout method. This field is not set if the payout method is in a
failed
,canceled
, orreturned
state. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z. - fromobject
The FinancialAccount that funds were pulled from.
- livemodeboolean
Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - metadatanullable map
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- outbound_
payment_ quotenullable stringPreview feature The quote for this OutboundPayment. Only required for countries with regulatory mandates to display fee estimates before OutboundPayment creation.
- receipt_
urlnullable string A link to the Stripe-hosted receipt for this OutboundPayment. The receipt link remains active for 60 days from the OutboundPayment creation date. After this period, the link will expire and the receipt url value will be null.
- recipient_
notificationobject Details about the OutboundPayment notification settings for recipient.
- statement_
descriptorstring The description that appears on the receiving end for an OutboundPayment (for example, bank statement for external bank transfer).
- statusenum
Current status of the OutboundPayment:
processing
,failed
,posted
,returned
,canceled
. An OutboundPayment isprocessing
if it has been created and is processing. The status changes toposted
once the OutboundPayment has been “confirmed” and funds have left the account, or tofailed
orcanceled
. If an OutboundPayment fails to arrive at its payout method, its status will change toreturned
.Possible enum valuescanceled
A user canceled the OutboundPayment before posting. Stripe returns the funds to the user by voiding the pending Transaction.
failed
The OutboundPayment failed to confirm. Stripe returns the funds to the user by voiding the pending Transaction.
posted
The OutboundPayment posted and funds have left the account. The underlying Transaction posts.
processing
The OutboundPayment starting state. Funds are “held” by a pending Transaction (but are still part of the current balance). The OutboundPayment might be cancelable by the user, depending on the value of the cancelable field.
returned
The OutboundPayment failed to successfully arrive at the destination. Funds return to the user with a second posted Transaction attached to the same flow.
- status_
detailsnullable object Status details for an OutboundPayment in a
failed
orreturned
state. - status_
transitionsnullable object Hash containing timestamps of when the object transitioned to a particular status.
- toobject
To which payout method the OutboundPayment was sent.
- trace_
idobjectPreview feature A unique identifier that can be used to track this OutboundPayment with recipient bank. Banks might call this a “reference number” or something similar.
Error returned when the recipient account in the OutboundPayment request is not configured as a recipient.
Error returned when the specified amount exceeds the payout method’s amount limits.
Error returned when user selected a delivery option but the specified amount exceeds the method limits.
Error returned when the provided Card payout method is not eligible for outbound payment.
Error returned when the Confirmation of Payee is not accepted.
Error returned when a payout method is not provided in the OutboundPayment request and the recipient account does not have a default payout method.
Error returned when the selected delivery option is not supported for the payout method.
Error returned when the balance type in the OutboundPayment request does not support the provided currency.
Error returned when rate locking in the used OBPQ is expired.
Error returned when the balance of provided financial account and balance type in the OutboundPayment request does not have enough funds.
Error returned when the payout method country does not match the recipient account country.
Error returned when user does not specify the delivery option or provides automatic, and the amount exceeds all the possible delivery options for this payout method.
Error returned when the user is not allowed to make this OutboundPayment request.
Error returned when the provided payout method is expired.
Error returned when the FX rate drift beyond threshold.
Error returned when key money movement fields on outbound payment quote creation request don’t match outbound payment creation request, including from, to, amount and delivery_options.
Error returned when outbound payment quote is missing for CBPs that requires fee and amount estimates prior to OBP initiation.
Error returned when the recipient’s recent total amount in outbound payments has exceeded its limit.
Error returned when the recipient’s recent outbound payment count has exceeded its limit.
Error returned when the user enables notifications in the OutboundPayment request, but an email is not set up on the recipient account.
Error returned when recipient does not have the active features required to receive funds from this OutboundPayment request.
Error returned when user does not specify the delivery option or provides automatic, and recipient feature is not active for suitable delivery option.
Error returned when the payout method does not support the request’s payout method currency.
Deprecated. Error returned when balance type of provided financial account in the OutboundPayment request cannot be identified.
Error returned when financial account in the OutboundPayment request cannot be identified.
Error returned when the payout method in the OutboundPayment request cannot be identified.
Error returned when the recipient account in the OutboundPayment request cannot be identified.
An idempotent retry results in resource conflicts.
An idempotent retry occurred with different request parameters.
{ "id": "obp_test_65OAfT9tVl3u223h0he16NybHIZ4SQ3LORe4rpuNGDIKCO", "object": "v2.money_management.outbound_payment", "amount": { "value": 1000, "currency": "usd" }, "from": { "debited": { "value": 1000, "currency": "usd" }, "financial_account": "fa_test_65NybHaQx7KJxDc22rZ16NybHIZ4SQ3LORe4rpuNGDIXEO" }, "to": { "credited": { "value": 1000, "currency": "usd" }, "recipient": "acct_test_61Nyc6oHjbwlpjhvd66Nyc6oZ4SQv89ZZAqvHiCECJ3g", "payout_method": "usba_test_61Nyd9YFBVUzLyxXZ16Nyc6oZ4SQv89ZZAqvHiCEC9VQ" }, "delivery_options": { "bank_account": "automatic" }, "statement_descriptor": "Payment for streaming earnings", "cancelable": true, "description": "Streamer earnings", "status": "processing", "status_transitions": {}, "receipt_url": "https://payments.stripe.com/transaction_receipt/CCMaIwohd2tzcF90ZXN0XzZOeWJISVo0U1EzTE9SZTRycHVOR0RJKOPfpqIGMgZn4xRNQi06oQGUu_fPQJBHgptVXysoOIKNwdFbokEtoKYNk662ox8FRx8ldoJpnlZyFXloJjMW5AQ5dqSks8HidH5PkHyYO91-dYHRZ8kj93mfh2l_efexFDN6EmiZj21RiNDALXuagy2MHFmfrkh6ZiAnjp-MOgqg8IM1RA5Ry5IDL-21Xiair1jWxuVJb3inbrbntL3nk6yjUtXcd_QLofG-Sj2Yz9-NEA", "created": "2023-04-26T23:12:35.952Z", "expected_arrival_date": "2023-04-28T00:00:00Z", "recipient_notification": { "setting": "configured" }, "trace_id": { "status": "pending", "value": "" }, "outbound_payment_quote": null}
Retrieves the details of an existing OutboundPayment by passing the unique OutboundPayment ID from either the OutboundPayment create or list response.
Parameters
- idstringRequired
The ID of the OutboundPayment to retrieve.
Returns
Response attributes
- idstring
Unique identifier for the OutboundPayment.
- objectstring, value is "v2.money_management.outbound_payment"
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 OutboundPayment.
- cancelableboolean
Returns true if the OutboundPayment can be canceled, and false otherwise.
- createdtimestamp
Time at which the OutboundPayment 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.
- descriptionnullable string
An arbitrary string attached to the OutboundPayment. Often useful for displaying to users.
- expected_
arrival_ datenullable timestamp The date when funds are expected to arrive in the payout method. This field is not set if the payout method is in a
failed
,canceled
, orreturned
state. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z. - fromobject
The FinancialAccount that funds were pulled from.
- livemodeboolean
Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - metadatanullable map
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- outbound_
payment_ quotenullable stringPreview feature The quote for this OutboundPayment. Only required for countries with regulatory mandates to display fee estimates before OutboundPayment creation.
- receipt_
urlnullable string A link to the Stripe-hosted receipt for this OutboundPayment. The receipt link remains active for 60 days from the OutboundPayment creation date. After this period, the link will expire and the receipt url value will be null.
- recipient_
notificationobject Details about the OutboundPayment notification settings for recipient.
- statement_
descriptorstring The description that appears on the receiving end for an OutboundPayment (for example, bank statement for external bank transfer).
- statusenum
Current status of the OutboundPayment:
processing
,failed
,posted
,returned
,canceled
. An OutboundPayment isprocessing
if it has been created and is processing. The status changes toposted
once the OutboundPayment has been “confirmed” and funds have left the account, or tofailed
orcanceled
. If an OutboundPayment fails to arrive at its payout method, its status will change toreturned
.Possible enum valuescanceled
A user canceled the OutboundPayment before posting. Stripe returns the funds to the user by voiding the pending Transaction.
failed
The OutboundPayment failed to confirm. Stripe returns the funds to the user by voiding the pending Transaction.
posted
The OutboundPayment posted and funds have left the account. The underlying Transaction posts.
processing
The OutboundPayment starting state. Funds are “held” by a pending Transaction (but are still part of the current balance). The OutboundPayment might be cancelable by the user, depending on the value of the cancelable field.
returned
The OutboundPayment failed to successfully arrive at the destination. Funds return to the user with a second posted Transaction attached to the same flow.
- status_
detailsnullable object Status details for an OutboundPayment in a
failed
orreturned
state. - status_
transitionsnullable object Hash containing timestamps of when the object transitioned to a particular status.
- toobject
To which payout method the OutboundPayment was sent.
- trace_
idobjectPreview feature A unique identifier that can be used to track this OutboundPayment with recipient bank. Banks might call this a “reference number” or something similar.
The resource wasn’t found.
{ "id": "obp_test_65OAfT9tVl3u223h0he16NybHIZ4SQ3LORe4rpuNGDIKCO", "object": "v2.money_management.outbound_payment", "from": { "financial_account": "fa_test_65NybHaQx7KJxDc22rZ16NybHIZ4SQ3LORe4rpuNGDIXEO", "debited": { "value": 1000, "currency": "usd" } }, "to": { "credited": { "value": 1000, "currency": "usd" }, "recipient": "acct_test_61Nyc6oHjbwlpjhvd66Nyc6oZ4SQv89ZZAqvHiCECJ3g", "payout_method": "usba_test_61Nyd9YFBVUzLyxXZ16Nyc6oZ4SQv89ZZAqvHiCEC9VQ" }, "delivery_options": { "bank_account": "automatic" }, "amount": { "value": 1000, "currency": "usd" }, "statement_descriptor": "Payment for streaming earnings", "cancelable": true, "description": "Streamer earnings", "status": "processing", "status_transitions": {}, "receipt_url": "https://payments.stripe.com/transaction_receipt/CCMaIwohd2tzcF90ZXN0XzZOeWJISVo0U1EzTE9SZTRycHVOR0RJKMPgpqIGMgbztcBwNg46oQGUmYI69-O84chYtSQDFeO22gsaZPBsi9OkhxmOvY_z5ElXLqPGy_WUkLZ0XuCmjerVOR-ZnrOKDcHldqWvsxHXRaRnjq2SLu5V7tJaYWNe3_Vy2VhWmJ8H09qAOl8HxjS9prFckpisbEa_1u53hKgIXZVoI4FEOVWgFcf0-d7ev6zL728kPw-QcXbRkPi-wwaIXwxRNbyTpsBi6KzQ7PTqlg", "created": "2023-04-26T23:12:35.952Z", "expected_arrival_date": "2023-04-28T00:00:00Z", "recipient_notification": { "setting": "configured" }, "trace_id": { "status": "pending", "value": "" }, "outbound_payment_quote": null}
Returns a list of OutboundPayments that match the provided filters.
Parameters
- createdtimestamp
Filter for objects created at the specified timestamp. Must be an RFC 3339 date & time value, for example: 2022-09-18T13:22:00Z.
- created_
gttimestamp Filter for objects created after the specified timestamp. Must be an RFC 3339 date & time value, for example: 2022-09-18T13:22:00Z.
- created_
gtetimestamp Filter for objects created on or after the specified timestamp. Must be an RFC 3339 date & time value, for example: 2022-09-18T13:22:00Z.
- created_
lttimestamp Filter for objects created before the specified timestamp. Must be an RFC 3339 date & time value, for example: 2022-09-18T13:22:00Z.
- created_
ltetimestamp Filter for objects created on or before the specified timestamp. Must be an RFC 3339 date & time value, for example: 2022-09-18T13:22:00Z.
- limitinteger
The maximum number of results to return.
- pagestring
The page token to use to retrieve the page being requested.
- recipientstring
Only return OutboundPayments sent to this recipient.
- statusarray of enums
Closed Enum. Only return OutboundPayments with this status.
Possible enum valuescanceled
A user canceled the OutboundPayment before posting. Stripe returns the funds to the user by voiding the pending Transaction.
failed
The OutboundPayment failed to confirm. Stripe returns the funds to the user by voiding the pending Transaction.
posted
The OutboundPayment posted and funds have left the account. The underlying Transaction posts.
processing
The OutboundPayment starting state. Funds are “held” by a pending Transaction (but are still part of the current balance). The OutboundPayment might be cancelable by the user, depending on the value of the cancelable field.
returned
The OutboundPayment failed to successfully arrive at the destination. Funds return to the user with a second posted Transaction attached to the same flow.
Returns
Response attributes
- dataarray of objects
The OutboundPayments retrieved.
- next_
page_ urlnullable string The URL for the next page of results.
- previous_
page_ urlnullable string The URL for the previous page of results.
Error returned when the page token provided in the OutboundPayments list request is invalid.
{ "data": [ { "id": "obp_test_65OAfUM3B6hTbQdW72y16NybHIZ4SQ3LORe4rpuNGDIWJM", "object": "v2.money_management.outbound_payment", "from": { "financial_account": "fa_test_65NybHaQx7KJxDc22rZ16NybHIZ4SQ3LORe4rpuNGDIXEO", "debited": { "value": 1000, "currency": "usd" } }, "to": { "recipient": "acct_test_61Nyc6oHjbwlpjhvd66Nyc6oZ4SQv89ZZAqvHiCECJ3g", "payout_method": "usba_test_61Nyd9YFBVUzLyxXZ16Nyc6oZ4SQv89ZZAqvHiCEC9VQ", "credited": { "value": 1000, "currency": "usd" } }, "delivery_options": { "bank_account": "automatic" }, "amount": { "value": 1000, "currency": "usd" }, "statement_descriptor": "Payment for streaming earnings", "cancelable": false, "description": "Streamer earnings", "status": "canceled", "status_transitions": { "canceled_at": "2023-04-26T23:14:58.321Z" }, "receipt_url": "https://payments.stripe.com/transaction_receipt/CCMaIwohd2tzcF90ZXN0XzZOeWJISVo0U1EzTE9SZTRycHVOR0RJKKHhpqIGMgZRo1m_xhE6oQGUeczbdUAAGdSgXTI6R9NnQ_eY4wM5AiYAzeF5toQDEwk6sb74cUc8RCZq5DyHcAlT1SVg7l1aD0tUo8EmPzAAkMo_E0csmP-ANJqI53kErMF1ZY4sY9Z-eV7hAGhk3ATl0HgwfNMWjueJJ4I93-wybLjOfQtozFwQgXbSjvN_nYTF4XMPa_IEwFrzAnLnedX5YVZcQIE8o84-GeLtYCsh6Q", "created": "2023-04-26T23:13:51.767Z", "expected_arrival_date": "2023-04-28T00:00:00Z", "recipient_notification": { "setting": "configured" }, "trace_id": { "status": "pending", "value": "" }, "outbound_payment_quote": null }, { "id": "obp_test_65OAfT9tVl3u223h0he16NybHIZ4SQ3LORe4rpuNGDIKCO", "object": "v2.money_management.outbound_payment", "from": { "financial_account": "fa_test_65NybHaQx7KJxDc22rZ16NybHIZ4SQ3LORe4rpuNGDIXEO", "debited": { "value": 70, "currency": "usd" } }, "to": { "recipient": "acct_test_61Nyc6oHjbwlpjhvd66Nyc6oZ4SQv89ZZAqvHiCECJ3g", "payout_method": "usba_test_61Nyd9YFBVUzLyxXZ16Nyc6oZ4SQv89ZZAqvHiCEC9VQ", "credited": { "value": 70, "currency": "usd" } }, "delivery_options": { "bank_account": "automatic" }, "amount": { "value": 70, "currency": "usd" }, "statement_descriptor": "Payment for streaming earnings", "cancelable": true, "description": "Streamer earnings", "status": "processing", "status_transitions": {}, "receipt_url": "https://payments.stripe.com/transaction_receipt/CCMaIwohd2tzcF90ZXN0XzZOeWJISVo0U1EzTE9SZTRycHVOR0RJKKHhpqIGMgaHLLakVjE6oQGUBP4uoz2TYLGepLSM0zU62Irj-5PfTqRlvJwjXRX5AM0K0WPzvIl8BNGa1XqDxL1bJ3-L4kioq0lFL3iPVNmPQ4PxQZzl82wJD8WFZUSkFVMeug5VPGcMYmXtiUYYc9Ir3v2IIjUf213H-Jg3-v0432XfxdHnlrVoN_1okeCtH80xJC24j64hX2_5RrB7bCmCiUPF8MsyChh218bP3YqxEQ", "created": "2023-04-26T23:12:35.952Z", "expected_arrival_date": "2023-04-28T00:00:00Z", "recipient_notification": { "setting": "configured" }, "trace_id": { "status": "pending", "value": "" }, "outbound_payment_quote": null } ]}