Receipts

Rail provides receipts for every withdrawal executed on the Rail platform. Rail makes retrieving receipts easy and sends notifications to inform clients when a receipt is available, once the withdrawal is executed. Receipts are also referred to as 'transmission receipts'.

Retrieving Receipts

There are two apporaches to retrieve receipts 1. via API and 2. via the Management UI.

Retrieving Receipts via API

You can retrieve receipts for specific withdrawal via API using the Retrieve Withdrawal Receipt end point.
API endpoint - /withdrawals/{withdrawal_id}/receipt

Retrieving Receipts via Management UI

You can also retrieve receipts using the portal.

1. After logging into the Management UI, navigate to the Money Movement section of the portal.
2. Switch to the Withdrawals tab and find the withdrawal you wish to retreive the receipt for.
3. On the Details tab click the Download Receipt button to download the receipt for the given withdrawal.

Receipt Notifications

Rail leverages the transaction posted webhook to notify clients when a receipt is available. When a withdrawal is successfully executed an event called TRANSACTION_POSTED is emitted, which notifies you that a the receipts associated with the withdrawal is available. The event with have WITHDRWAL as the categorytype, and the categoryid represents the withdrawal id the receipt has just been made available for.

Using one of the above apporaches, you can then easily retrieve the receipt you were just notified about.