Invoices REST API
v1.0.0
Introduction
In order to start querying the Transfermate Education Invoice API you need to contact Transfermate and request the following details:
There are 4 stages to successfully booking a payment using the Transfermate Education API.
- The API URL
- The Sandbox Credentials (Username/Password)
- The Secret Key – For verifying the integrity and the authenticity of the response messages.
- A Default Webhook URL
This is the URL to which Transfermate will send payment status updates.
Please note that if you don’t provide such URL, we won’t be able to notify you when a payment status is updated on our end and you will have to query the Invoice Payment API to get the payment statuses.
See Webhook Notification Service section for more information. - Settlement Bank Account Details
We will import your Settlement Bank Account Details into our system and provide you with the Bank Account IDs which you must reference in the InvoicePayment or the InvoiceFX API call.
The Base Currency and the settlement process depend on the Bank Account ID which you provide in the API calls.
Bank Account Name | Settlement / Base Currency | Bank Account ID |
---|---|---|
Test Bank Account (CAD) | CAD | 4609 |
Test Bank Account (EUR) | EUR | 3438 |
Test Bank Account (GBP) | GBP | 12611 |
Test Bank Account (AUD) | AUD | 12612 |
Test Bank Account (USD) | USD | 13004 |
Test Bank Account (BRL) | BRL | 33604 |
There are 4 stages to successfully booking a payment using the Transfermate Education API.
- Call the InvoiceFX API endpoint to get a list with available payment methods, the associated charges and the payment flow.
- Display the payment methods for selection by the student / payer.
- Call the InvoicePayment API endpoint to register the payment in the Transfermate system.
- The payment is booked.