Payouts

Payouts represent transfers from Straddle to customer bank accounts. Create payouts to handle disbursements, process refunds, or manage marketplace settlements. Use payouts to send money quickly and securely with the most cost-effective rail automatically selected.

Lookup a payout

PayoutV1 Payouts.Get(, )

GET/v1/payouts/{id}

Update a payout

PayoutV1 Payouts.Update(, )

PUT/v1/payouts/{id}

Create a payout

PayoutV1 Payouts.Create(, )

POST/v1/payouts

Hold a payout

PayoutV1 Payouts.Hold(, )

PUT/v1/payouts/{id}/hold

Release a payout

PayoutV1 Payouts.Release(, )

PUT/v1/payouts/{id}/release

Cancel a payout

PayoutV1 Payouts.Cancel(, )

PUT/v1/payouts/{id}/cancel

Get a payout by id.

PayoutUnmaskResponse Payouts.Unmask(, )

GET/v1/payouts/{id}/unmask

Upload a proof-of-authorization document for a payout.

PayoutV1 Payouts.UploadAuthorizationDocument(, )

POST/v1/payouts/{id}/authorization

ModelsExpand Collapse

class PayoutV1:

required Data Data

required string ID

Unique identifier for the payout.

formatuuid

required Int Amount

The amount of the payout in cents.

formatint32

required Config Config

Configuration for the payout.

Boolean? AutoHold

Defines whether to automatically place this charge on hold after being created.

string? AutoHoldMessage

The reason the payout is being automatically held on creation.

SandboxOutcome SandboxOutcome

Payment will simulate processing if not Standard.

One of the following:

required string Currency

The currency of the payout. Only USD is supported.

required string? Description

An arbitrary description for the payout.

required DeviceInfoV1 Device

Information about the device used when the customer authorized the payout.

required string IPAddress

The IP address of the device used when the customer authorized the charge or payout. Use 0.0.0.0 to represent an offline consent interaction.

formatipv4

required string ExternalID

Unique identifier for the payout in your database. This value must be unique across all payouts.

required IReadOnlyList<string> FundingIds

Funding Ids

required Boolean HasResubmit

Has the payout been resubmitted.

required Boolean IsRefund

Is the payout a refund of an original charge.

required Boolean IsResubmit

Is the payout a resubmit of an original payout.

required string Paykey

Value of the paykey used for the payout.

required DateOnly PaymentDate

The desired date on which the payment should be occur. For payouts, this means the date you want the funds to be sent from your bank account.

formatdate

required Status Status

The current status of the payout.

One of the following:

required StatusDetailsV1 StatusDetails

Details about the current status of the payout.

required DateTimeOffset ChangedAt

The time the status change occurred.

formatdate-time

required string Message

A human-readable description of the current status.

required Reason Reason

A machine-readable identifier for the specific status, useful for programmatic handling.

One of the following:

required Source Source

Identifies the origin of the status change (e.g., bank_decline, watchtower). This helps in tracking the cause of status updates.

One of the following:

string? Code

The status code if applicable.

required IReadOnlyList<StatusHistory> StatusHistory

History of the status changes for the payout.

required DateTimeOffset ChangedAt

The time the status change occurred.

formatdate-time

required string Message

A human-readable description of the status.

required Reason Reason

A machine-readable identifier for the specific status, useful for programmatic handling.

One of the following:

required Source Source

Identifies the origin of the status change (e.g., bank_decline, watchtower). This helps in tracking the cause of status updates.

One of the following:

required Status Status

The current status of the charge or payout.

One of the following:

string? Code

The status code if applicable.

required IReadOnlyDictionary<string, string> TraceIds

Trace Ids.

DateTimeOffset? CreatedAt

The time the payout was created.

formatdate-time

CustomerDetailsV1 CustomerDetails

Information about the customer associated with the payout.

required string ID

Unique identifier for the customer

formatuuid

required CustomerType CustomerType

The type of customer

One of the following:

required string Email

The customer's email address

required string Name

The name of the customer

required string Phone

The customer's phone number in E.164 format

IReadOnlyList<Document>? Documents

Documents uploaded for this payout (e.g. proof of authorization), in the order they were uploaded.

required string DocumentID

Unique identifier for this document.

formatuuid

required string DocumentName

The file name of this document as uploaded.

required Long DocumentSize

The size of this document in bytes.

formatint64

required DocumentType DocumentType

required DateTimeOffset UploadedAt

The UTC timestamp when this document was uploaded.

formatdate-time

DateTimeOffset? EffectiveAt

The actual date on which the payment occurred. For payouts, this is the date the funds were sent from your bank account.

formatdate-time

IReadOnlyDictionary<string, string>? Metadata

Up to 20 additional user-defined key-value pairs. Useful for storing additional information about the payout in a structured format.

PaykeyDetailsV1 PaykeyDetails

Information about the paykey used for the payout.

required string ID

Unique identifier for the paykey.

formatuuid

required string CustomerID

Unique identifier for the customer associated with the paykey.

formatuuid

required string Label

Human-readable label that combines the bank name and masked account number to help easility represent this paykey in a UI

Int? Balance

The most recent balance of the bank account associated with the paykey in dollars.

formatint32

PaymentRail PaymentRail

The payment rail used for the payout.

DateTimeOffset? ProcessedAt

The time the payout was processed by Straddle and originated to the payment rail.

formatdate-time

IReadOnlyList<RelatedPayment>? RelatedPayments

Related payments.

required string ID

The ID of the related payment.

formatuuid

required PaymentType PaymentType

The type of payment.

One of the following:

required Relationship Relationship

One of the following:

DateTimeOffset? UpdatedAt

The time the payout was last updated.

formatdate-time

required ResponseMetadata Meta

Metadata about the API request, including an identifier and timestamp.

required string ApiRequestID

Unique identifier for this API request, useful for troubleshooting.

formatuuid

required DateTimeOffset ApiRequestTimestamp

Timestamp for this API request, useful for troubleshooting.

formatdate-time

required ResponseType ResponseType

Indicates the structure of the returned content.

"object" means the data field contains a single JSON object.
"array" means the data field contains an array of objects.
"error" means the data field contains an error object with details of the issue.
"none" means no data is returned.

One of the following: