POST
/
payoutTargets

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
bankAccount
object
required
customerId
string
required

The ID of the customer for whom the Payout Target is created.

redirectUrl
string
required

URL to which the customer will be redirected after the authorization process.

type
enum<string>
required
Available options:
bankAccount
description
string

An optional description of the Payout Target.

reference
string

An optional reference provided by the merchant to identify the Payout Target.

Response

200 - application/json
authUrl
string

URL where the customer should be redirected to complete the Payout Target verification.

createdAt
string

ISO string indicating when the Payout Target was created.

customerDetails
object

Details about the customer who owns this Payout Target.

customerId
string

Reference to customer who owns this Payout Target.

description
string

An extra metadata field that can be included for visibility.

id
string

Unique identifier for this Payout Target.

redirectUrl
string

URL where the customer will be redirected after completing the Payout Target verification.

reference
string

Reference sent in by merchant to identify Payout Target.

status
enum<string>

Status of the Payout Target.

Available options:
active,
cancelled
statusMessage
enum<string>

Additional detail on the status. Only present when status is "cancelled".

Available options:
AUTHENTICATION_FAILED,
CUSTOMER_CANCELLATION,
DECLINED_BY_BANK,
EXPIRED,
INVALID_ACCOUNT,
NOT_ENOUGH_FUNDS,
ERROR
type
enum<string>

Type of Payout Target created.

Available options:
bankAccount
updatedAt
string

ISO string indicating when the Payout Target was last updated.