For outbound payments (the ones you send), see Payment statuses.
The platform builds, signs and submits the confirmation messages on your behalf. No integration work is required - the mode is a single tenant setting.
Confirmation modes at a glance
How automatic confirmation works
1
Payment received and credited
The inbound payment lands directly as Completed - the beneficiary is credited on receipt, with no intermediate status. You receive a single webhook (
Completed, direction=INBOUND).2
Final confirmation sent
ACCC - “payment credited to beneficiary” - is sent to the gpi Tracker immediately. The sender’s bank sees the outcome in real time.Cover payments (COVE)
Some correspondents settle in two parts: the customer payment (pacs.008) only announces the transfer, while the actual money moves separately as a bank-to-bank cover transfer (pacs.009 COV). The payment must not be credited until the cover arrives.
1
Payment announced, funds not yet in
The inbound payment lands as Accepted and waits with the reason
awaiting_cover (visible via GET /v3/payments/{id}, not in the webhook). The beneficiary is not credited yet. An interim ACSP/G004 confirmation (“awaiting cover”) is sent to the Tracker immediately.2
Cover arrives
The matching
pacs.009 COV comes in and the platform matches it to the waiting payment automatically.3
Auto-completed
In automatic mode the payment completes right away: status Completed, webhook sent, final
ACCC confirmation goes to the Tracker.Confirmation status codes
Returning a completed payment
Even after a payment is completed and credited, you can still return it to the sender - a beneficiary’s request, a compliance issue that surfaced later. The original stays Completed; the money goes back as a separate Payment return transaction.Payment returns
Full flow, return reasons and the returns API
Webhooks
API Reference
Get payment
GET /v3/payments/{id} - read the statusReason (awaiting_cover)Return payment
POST /v3/payments/{id}/returns - return a completed paymentNext Steps
Manual confirmation
Hold payments for compliance review instead
Statements
Reconcile received funds