latestOpenAPI 3.1.02026-08-22124199170.4 KB

8a237f1f704f

payments

Retrieve AFT Payment Request

Retrieve a single AFT payment by the id returned at creation time. Only Pull payments are matched, and only for consumers belonging to the authenticated partner — anything else returns 404.

get/v2/payments/aft/{id}/

Path parameters

idstring uuid required

The unique ID of the AFT payment (returned at creation time).

Headers

Authorizationstring required

Bearer authentication

Response

idstring uuid required

Unique identifier for this payment. Use it with GET /v2/payments/aft/{id}/.

consumer_idstring uuid required

External ID of the consumer associated with this payment.

external_payment_card_idstring uuid required

External ID of the payment card that was debited.

amountnumber double required

Gross transfer amount in USD, inclusive of fee_amount.

fee_amountnumber double required

Fee deducted from amount. The DDA is credited amount - fee_amount.

descriptionstring

Description recorded against the transaction.

direction'Pull' required

Always Pull for AFT transactions.

status'queued' | 'pending' | 'pending_review' | 'posted' | 'canceled' | 'error' | 'rejected' | 'returned' required

Lifecycle status of a card payment. pending is returned at creation; posted means funds have settled. pending_review indicates the payment is held for compliance review.