Payout
Fields every transaction has — payin, refund and payout.
objectandmethod_typetell which fields come on top; the fields of the payment instrument are in an object named after it —card,apple_payorgoogle_pay.- Properties: 2amountType:required
- createdType: stringFormat: date-time
_at requiredthe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- idType: stringFormat: uuidrequired
Transaction id. The type of the transaction is in
object. - merchantType:
_reference min length:1max length:100requiredYour id for the transaction, unique per merchant across payins, refunds, payouts and pay sessions. It is also the idempotency key of the create — the same reference with the same body returns the existing transaction, with a different body
409 merchant_reference_conflict. Never expires. - methodenum
_type const:payout_cardrequired - objectconst:payoutrequired
- statusType: enumrequiredvalues
- created
Recorded. Not final.
- processing
Checks or provider in progress. Not final.
- completed
Credited to the recipient. Final.
- failed
Not credited — read
status_details.code. The blocked amount is returned to the balance. Final.
- created
- statusType: nullable
_details requiredProperties: 2Why the transaction ended
failed.nullin every other status. - updatedType: stringFormat: date-time
_at requiredthe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- cardType: objectProperties: 2
Set when
method_typeispayout_card. - rrnType: string
Retrieval reference number of the payout in the card network, when the provider returns it. Lets the recipient's bank find the payment.