Cancelations
Cancelations will be represented on a daily cancelation report in CSV format provided by ReadyRemit via an SFTP process.
File spec
| Column | Description | Format | Example |
|---|---|---|---|
| Customer name | Name of customer | String | Chime |
| Transfer ID | Unique ID of the transfer defined by ReadyRemit | String | f592edb9-f094-49cc-8f00-7c4168b80ed8 |
| Confirmation number | Unique ID of the transfer defined by the remittance service provider | String | 33TF030740448 |
| Transfer date time | Date and time the transfer was originally submitted (in UTC) | MM/dd/YYYY hh:mm:ss tt | 10/03/2022 11:19:31 AM |
| Sender name | Full name of the sender | String | Kyle Fix |
| Recipient name | Full name of recipient | String | Jennifer Fix |
| Send amount | Total amount sent by the user | Number with 2 decimal places | 150.00 |
| Transfer fee | Total fee amount | Number with 2 decimal places | 3.00 |
| Total credit amount | Total cost amount (send amount + fee) | Number with 2 decimal places | 153.00 |
| Cancelation reason | Reason for cancelation defined during cancelation. | String | ACCOUNT DOES NOT SUPPORT PAYMENT |
| Proxy number | Card proxy number (available if ingested during transfer) | String | ABC123XYZ |
| RSP Name | The remittance service provider that was used for the original transfer of funds | String | Transpay |
- The file will use the following naming convention:
Customer_ReadyRemit_Daily_Cancelled_Transfers_MMDDYY.csv - The file will have a header row
- The file will be generated whether there are cancelations or not. If there are no cancelations in the applicable time period, the report will have no data rows (header row will still be present)
- The file will be sent daily at 6:00AM EST (10:00 AM UTC)
- The last row of the cancelations file will be a summary row with totals for Send amount, Transfer fee, and Total credit amount.
Summary row
The last row of the file will be a summary row with totals for Send amount, Transfer fee, and Total credit amount. This row will not contain ID information for any specific transfer and should not be processed as a cancelation.
Sample
Customer name,Transfer ID,Confirmation number,Transaction date time,Sender name,Recipient name,Send amount,Transfer fee,Total credit amount,Cancelation reason,Proxy number
PrePaid Technologies,f592edb9-f094-49cc-8f00-7c4168b80ed8,33TF030740448,10/03/2022 11:19:31 AM,Kyle Fix,Jennifer Fix,100.00,2.99,102.99,ACCOUNT DOES NOT SUPPORT PAYMENT,ABC123XYZ
PrePaid Technologies,eu3719c3-l000-4ix2-4u77-3hc28skn3bd5,33TF001912288,10/02/2022 4:08:38 AM,Daniel Chimento,Dana John,558.00,3.99,561.99,ACCOUNT DOES NOT SUPPORT PAYMENT,DEF456GHI
Report Delivery
The cancelations report can be delivered one of three ways:
1. Email
The quickest solution to receiving the cancelations report is through email. An email address will be provided to the ReadyRemit integrations team and the report will be delivered daily as an attachment.
2. SFTP (pull)
If a more automated process is desired the cancelations report can be delivered via SFTP. In the "pull" model, the ReadyRemit integrations team will provide you with SFTP credentials and you will provide ReadyRemit with a public key for encryption. Files will be dropped in the determined SFTP directory on a daily basis.
3. SFTP (push)
Similar to the pull model, in the SFTP push model a file is generated and dropped in an agreed upon SFTP directory. In this model you will provide the ReadyRemit team with SFTP credentials along with the public encryption key.
Next steps
To get started with the process of receiving the cancelations report, please reach out to the ReadyRemit integrations team at [email protected].
Updated 7 months ago