9.7 - Exceptions Report
Each report contains the exceptions related to one partner. One file is generated per day with the filename as follows: Exceptions_YYYY_MM_DD.json
Exceptions files are delivered to a partner's folder on the Rapyd SFTP server at around 00:15 GMT.
Information
Please note that this page is only relevant to Payment Facilitators
9.7.1 - Exception
| Field name | Length/type | Nullable | Description |
|---|---|---|---|
| Timestamp | DateTime | Y | Exception identifier |
| Amount | decimal | The exception amount | |
| Currency | 3 | The exception currency | |
| Key | 6 | Y | 6 letter key representing the type of exception. Descriptions of the keys can be found in the Dispute section |
| ReasonCode | 8 | 1-8 letter code showing the cause of the exception. Descriptions of the reason codes can be found in Dispute section under Visa and Mastercard. Note that there are separate tables for fraud report reason codes under the above-mentioned links. | |
| TransactionId | 12 | Y | Transaction ID assigned by Rapyd |
| ARN | 23 | Y | Acquirer Reference Number (ARN). Unique ID in Rapyd system |
| AgreementNumber | 6 | Y | The agreement number for the merchant |
| SourceAmount | decimal | The amount of the original transaction | |
| SourceCurrency | 3 | The currency of the original transaction | |
| Financial | bool | Y | Whether the exception key is financial or not |
| ReferenceData | 50 | Merchant assigned reference data. Also called merchantReferenceData | |
| TransactionLifeCycleId | 15 | Y | Identifier assigned by card schemes (not unique) |
| FraudType | 2 | 2 letter code describing the fraud type | |
| SchemeDisputeId | 11 | Y | 11 letter numeric ID describing the Scheme Dispute ID, left filled with zeros.The Scheme Dispute ID only applies to the following transaction types:CACB17CARV37CBRV35CHABACRCRV36RDR15RDR16RDR17RDR35RDR36RDR37RECB16REPR00REPR05REPR06REPR07RPRV25RPRV26RPRV27 |
9.7.2 - Example
[
{
"Timestamp": "2024-09-17T08:01:37.067932",
"Amount": -334.00,
"Currency": "EUR",
"Key": "CHABAC",
"ReasonCode": "4853 ",
"TransactionId": "402814483666",
"ARN": "75282524028132589224532",
"AgreementNumber": "230891",
"SourceAmount": 334.00,
"SourceCurrency": "EUR",
"Financial": true,
"ReferenceData": "tx_cXtDr2oTMf",
"TransactionLifeCycleId": "MCS298NAW0128 ",
"FraudType": " ",
"SchemeDisputeId": ""
},
{
"Timestamp": "2024-09-17T07:01:30.169243",
"Amount": -209.88,
"Currency": "EUR",
"Key": "CHABAC",
"ReasonCode": "13.1 ",
"TransactionId": "414322773449",
"ARN": "74648934144133694904838",
"AgreementNumber": "230891",
"SourceAmount": 209.88,
"SourceCurrency": "EUR",
"Financial": true,
"ReferenceData": "tx_a7nfJ2533Z",
"TransactionLifeCycleId": "484143821457966",
"FraudType": " ",
"SchemeDisputeId": ""
},
{
"Timestamp": "2024-09-17T07:01:30.169407",
"Amount": -183.38,
"Currency": "EUR",
"Key": "CHABAC",
"ReasonCode": "13.1 ",
"TransactionId": "413121422929",
"ARN": "74648934132133568287959",
"AgreementNumber": "230891",
"SourceAmount": 183.38,
"SourceCurrency": "EUR",
"Financial": true,
"ReferenceData": "tx_qktfQNcMpd",
"TransactionLifeCycleId": "484131788717972",
"FraudType": " ",
"SchemeDisputeId": ""
},
{
"Timestamp": "2024-09-17T11:10:40.920383",
"Amount": 29.75,
"Currency": "EUR",
"Key": "FRAUDR",
"ReasonCode": " ",
"TransactionId": "422718231749",
"ARN": "75282524228134579700701",
"AgreementNumber": "230791",
"SourceAmount": 32.54,
"SourceCurrency": "USD",
"Financial": false,
"ReferenceData": "tx_36XgPj4VBK",
"TransactionLifeCycleId": "MCSF0H6MP0714 ",
"FraudType": "06",
"SchemeDisputeId": ""
}
]