Transaction status update
Webhook
ISO-20022 pacs.002 message. Information about a transaction status update.
Event type: global.rtgs.TransactionStatusNotificationV1
The transaction status is in TxInfAndSts[].TxSts. StsRsnInf[].Rsn carries either a proprietary Prtry code or an ISO Cd, with AddtlInf providing a human-readable description.
Status transitions
TxSts | Prtry | Meaning |
|---|---|---|
PDNG | LinkPending | Your link request is pending a counterparty match. |
PDNG | LinkRequest | A counterparty's request was already pending when yours arrived; both are now waiting to be linked. |
PDNG | CounterpartyRequestCancelled | A counterparty that had matched your request cancelled theirs; your request remains pending. |
ACSP | LinkCreated | Matched with counterparty; settlement is in progress. |
ACSC | LinkSettled | Settlement complete. |
ACWP | OwnInsufficientFunds | Settlement failed: insufficient funds on your network account. |
ACWP | CounterpartyInsufficientFunds | Settlement failed: insufficient funds on the counterparty's network account. |
CANC | CancelledAsPerRequest | Cancellation successful. |
CANC | CounterpartyRequestCancelled | Counterparty cancelled their request. |
Rejection reasons
When TxSts is RJCT (request rejected) or ACWP with a reason code below (match validation failed), StsRsnInf[].Rsn carries one of the following.
Proprietary (Prtry) codes:
Prtry | AddtlInf |
|---|---|
CounterpartyNotFound | Counterparty does not exist |
CounterpartyInvalid | Counterparty is invalid |
OwnIdentifierInCounterpartyField | Participant BIC/LEI specified in counterparty field |
LinkIdentifiersOrUetrNotFound | Request link identifiers or UETR cannot be found |
VerificationFailed | Request signature verification has failed |
LinkAlreadySettled | Request has already been settled |
CurrencyMismatch | Requests have specified different currencies |
FundsControllerMismatch | Accounts held with different funds controllers |
SettlementFailed | Request has failed to settle and cannot be cancelled |
ClientIdMismatch | Accounts held by different clients |
ISO (Cd) codes:
Cd | AddtlInf |
|---|---|
AC02 | Invalid debtor account number |
AC03 | Invalid creditor account number |
AC10 | Invalid debtor account currency |
AC11 | Invalid creditor account currency |
AM09 | Request amounts do not match |
DU03 | Link identifiers already in use |
RF01 | Not Unique E2E TransactionReference (UETR) |
ED05 | Settlement failed |
NARR | Funds controller validation failed — returned when the funds controller rejects the request for a reason not covered by a more specific ISO code. |
Request
Responses
- 200
- 4XX
- 5XX
Return a successful status code if the message was received, understood and accepted.
Return a client error if the message contains bad syntax or cannot be fulfilled. Retries may be attempted.
Return a server error if the valid message failed to be fulfilled. Retries may be attempted.