Skip to content

9.6 - 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.6.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
ReasonCode 8 4-8 letter code showing the cause for the settlement
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)

9.6.2 - Example

[
  {
    "Timestamp": "2024-04-23T07:01:30.864396",
    "Amount": -822.02,
    "Currency": "EUR",
    "Key": "CHABAC",
    "ReasonCode": "13.1    ",
    "TransactionId": "408020003992",
    "ARN": "74648934081133070107332",
    "AgreementNumber": "230990",
    "SourceAmount": 822.02,
    "SourceCurrency": "EUR",
    "Financial": true,
    "ReferenceData": "payment_Y72eBnvrH6",
    "TransactionLifeCycleId": "484080725270788"
  },
  {
    "Timestamp": "2024-04-23T07:01:30.864777",
    "Amount": -60.97,
    "Currency": "EUR",
    "Key": "CHABAC",
    "ReasonCode": "13.1    ",
    "TransactionId": "335806629225",
    "ARN": "74648933358132317943150",
    "AgreementNumber": "230990",
    "SourceAmount": 60.97,
    "SourceCurrency": "EUR",
    "Financial": true,
    "ReferenceData": "payment_rV2Bw9aL41",
    "TransactionLifeCycleId": "483358228642489"
  },
  {
    "Timestamp": "2024-04-23T07:01:39.382632",
    "Amount": -641.00,
    "Currency": "EUR",
    "Key": "OUFE20",
    "ReasonCode": "13      ",
    "TransactionId": "402009263511",
    "ARN": "74648934020132523297579",
    "AgreementNumber": "230990",
    "SourceAmount": 641.00,
    "SourceCurrency": "EUR",
    "Financial": true,
    "ReferenceData": "payment_TXyp5rY9nm",
    "TransactionLifeCycleId": "484020357111613"
  },
  {
    "Timestamp": "2024-04-23T08:02:16.529327",
    "Amount": -54.09,
    "Currency": "EUR",
    "Key": "CHABAC",
    "ReasonCode": "4855    ",
    "TransactionId": "408505123893",
    "ARN": "75282524085133114194802",
    "AgreementNumber": "230990",
    "SourceAmount": 57.59,
    "SourceCurrency": "USD",
    "Financial": true,
    "ReferenceData": "payment_Sn3bpUhYrh",
    "TransactionLifeCycleId": "MCC2YPLAW0324  "
  },
  {
    "Timestamp": "2024-04-23T12:03:29.478060",
    "Amount": 24.95,
    "Currency": "USD",
    "Key": "FRAUDR",
    "ReasonCode": "1       ",
    "TransactionId": "404500976497",
    "ARN": "74507444045132735024796",
    "AgreementNumber": "349404",
    "SourceAmount": 3461.00,
    "SourceCurrency": "ISK",
    "Financial": false,
    "ReferenceData": "payment_os3LwkHQRw",
    "TransactionLifeCycleId": "464045026055225"
  },
  {
    "Timestamp": "2024-04-23T17:01:01.374787",
    "Amount": 0.00,
    "Currency": "USD",
    "Key": "CBLOST",
    "ReasonCode": "V1      ",
    "TransactionId": "405502253595",
    "ARN": "75290454055132828818231",
    "AgreementNumber": "349404",
    "SourceAmount": 0.00,
    "SourceCurrency": "   ",
    "Financial": false,
    "ReferenceData": "payment_arUfjd3x5T",
    "TransactionLifeCycleId": "MWEWU1Z0V0222  "
  }
]

Download exceptions file