- 18 Sep 2024
- 2 Minutes to read
- Print
- DarkLight
Payment status and codes
- Updated on 18 Sep 2024
- 2 Minutes to read
- Print
- DarkLight
When you submit a payment using a POST pacs.008 request, the payment will have an associated status and response code, including a brief description. You can send a GET pacs.002 request to retrieve this information:
Payment status is given in the fitoFIPmtStsRpt.txInfAndSts.txSts field.
Response code and description is given in the fitoFIPmtStsRpt.txInfAndSts.stsRsnInf.addtlInf field.
The Faster Payments (FP) response codes for different payment statuses are given in the following sections.
Pending status
Initially, once you have submitted the payment request, Payments Hub sets the transaction status to PEND, until it performs the transaction settlement and an accepted or rejected status is set. In the POST pacs.008 response this appears as PENDING and in the GET pacs.002 response it is PEND.
Accepted statuses
Table: Response codes for accepted payments.
Transaction status | Status code | Status description | Status sent from |
---|---|---|---|
ACCC | 0000 | Conditionally accepted without qualification. Payments Hub has completed the transaction, but the payment can still be returned until the beneficiary account is credited. | Faster Payments Service (FPS) |
ACSC | 0080 | Conditionally accepted but the approval date is not specified. Payments Hub has completed the transaction, but the payment can still be returned until the beneficiary account is credited. | FPS |
ACSC | 0081 | Conditionally accepted and approved on the same day. Payments Hub has completed the transaction, but the payment can still be returned until the beneficiary account is credited. | FPS |
ACSC | 0082 | Conditionally accepted and approved on the next day. Payments Hub has completed the transaction, but the payment can still be returned until the beneficiary account is credited. | FPS |
ACSC | 0083 | Conditionally accepted and approved on the next working day. Payments Hub has completed the transaction, but the payment can still be returned until the beneficiary account is credited. | FPS |
ACSC | 0084 | Conditionally accepted and approved on the working day following the next working day. Payments Hub has completed the transaction, but the payment can still be returned until the beneficiary account is credited. | FPS |
Rejected statuses
All rejected payments have the transaction status RJCT.
Table: Response codes for rejected payments.
Status code | Status description | Rejected by |
---|---|---|
AC02 | Debtor account number is invalid | Payments Hub |
AC03 | Creditor account number is invalid or missing | Payments Hub |
AM02 | Amount is more than £250,000 | Payments Hub |
AM03 | Currency is a value other than GBP | Payments Hub |
AM09 | Amount has more than 2 decimals | Payments Hub |
BE07 | Debtor address line is missing or is more than 140 chars | Payments Hub |
BE08 | Debtor name is missing | Payments Hub |
BE10 | Creditor name or creditor account name is more than 40 chars | Payments Hub |
BE20 | Debtor name or debtor account name is more than 40 chars | Payments Hub |
BE22 | Creditor name is missing for an overseas payment | Payments Hub |
CH15 | Creditor address line is more than 140 chars | Payments Hub |
NARR |
| Payments Hub |
RR09 | Structured creditor payment reference is more than 18 chars or is missing | Payments Hub |
RR10 | Invalid chars used | Payments Hub |
In addition to the above codes, Payments Hub can return any ISO20022 rejected status code. For a list of all possible values, download the ISO20022 external code set and navigate to the 16-StatusReason tab.