POST
/
payoutRequests

Authorizations

Authorization
string
header
required

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

Body

application/json
amount
number
required

Amount to be sent in COP. Must be greater than $1.000. The maxiumum is configured per merchant but defaults to $5.000.000. Contact us if you need to increase this limit.

payoutTargetId
string
required

Payout Target to send money to.

reference
string

Reference sent in by merchant to identify Payout Request.

sourceMerchantAccountId
string

An optional account ID of the source merchant account for this Payout Request.

Response

200 - application/json
amount
number

Amount to send to the customer’s Payout Target.

amountSent
number

Amount sent by Payout Request. Starts at amount and changes to 0 if cancelled.

createdAt
string

ISO string indicating when the Payout Request was created.

customerDetails
object

Details about the customer who owns the Payout Target for which the Payout Request was created.

customerId
string

Reference to customer who owns the Payout Target for which the Payout Request was created.

fee
number

Fee charged for the transaction. This fee will be subtracted from amountCollected at settlement time.

id
string

Unique identifier for this Payout Request.

payoutTargetDetails
object

Details about the Payout Target for which the Payout Request was created.

payoutTargetId
string

Reference to the Payout Target for which the Payout Request was created.

reference
string

Reference sent in by merchant to identify Payout Request.

sourceMerchantAccountId
string

Reference to Merchant Account. Safe to ignore if Merchant Accounts are not being used.

status
enum<string>

Status of the Payout Request.

Available options:
processing,
approved,
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
updatedAt
string

ISO string indicating when the Payout Request was last updated.