Main Use cases
The API allows to send a package of unsigned Foreign Currency Transfers (FCT) to the bank in the pain.001.001 format
Sending an unsigned payments to the bank
To upload an unsigned payments to the bank, you should:
- get AccessToken
- generate an xml in the pain.001.001 format. See the format specification on the page Import format
- send a POST request message
- receive a synchronous response with message status
Upload unsigned Foreign Currency Transfers
Request
| Request | POST /v1/iso20022/currency-transfer |
|---|---|
| Description |
Import of unsigned foreign currency payments in pain.001.001 format Note: only one message in pain.001.001 format can be upload via single POST /v1/iso20022/currency-transfer. But the message may contains a bunch of payments |
| Content-Type | application/xml |
| Body | xml in the pain.001.001 format |
Response
Bank will return a synchronous response that will contain:
- HTTP status code in accordance with standard
| HTTP status code | Message receipt status | Reason description |
|---|---|---|
| 200 | Created | The message successfully is accepted by the bank |
| 400 | Bad request | XML validation error |
| 401 | Unauthorized | Authorization error |
| 403 | Forbidden | Access is denied |
| 500 | Internal Server Error | An unexpected error has occurred (server unavailablity, etc.) |