SEPA Transfers

This module contains endpoints for transfer SEPA funds to other IBANs.

---

Create a SEPA transfer

Method: POST
Endpoint: /v1/sepa-transfer

Request

Request body - required

Name	Type	Required	Description
sourceExternalUserId	string	Yes	External user id (from your system)
currency	string	Yes	The cryptocurrency slug for the transfer (e.g., EUR)
amount	string	Yes	Amount to transfer
receiverFirstName	string	Required only if receiverType is NATURAL	Receiver first name
receiverLastName	string	Required only if receiverType is NATURAL	Receiver last name
companyName	string	Required only if receiverType is LEGAL	Company name
receiverType	string	Yes	Receiver type. Enum: [ NATURAL, LEGAL ]
destinationIban	string	Yes	Destination iban
transferTitle	string	Yes	Transfer title

Example body request

{
  "externalUserId": "bca65c48-df49-4831-a7b2-de7903321581",
  "currency": "eur",
  "amount": 100,
  "receiverFirstName": "John",
  "receiverLastName": "Doe",
  "receiverType": "NATURAL",
  "destinationIban": "LT601010012345678901",
  "transferTitle": "Bank transfer",
  "receiverType": "NATURAL"
}

Response

Code: 201
Description: Transfer created successfully

Example response

{
  "transferId": "7fb02323-969a-4936-94ea-86b8773ff1a2"
}

 

Code: 400
Description: User does not exist

Example response

{
  "errorCode": "P412",
  "errorName": "invalid-user"
}

 

Code: 400
Description: Partner not found

Example response

{
  "errorCode": "P418",
  "errorName": "partner-not-found"
}

 

Code: 400
Description: Insufficient funds

Example response

{
  "errorCode": "P433",
  "errorName": "insufficient-funds"
}

---

Get SEPA transfer details

Method: GET
Endpoint: /v1/sepa-transfer/details/:transferId

Request

Parameters - required

Name	Type	Required	Example	Description
transferId	string	Yes	7fb02323-969a-4936-94ea-86b8773ff1a2	Unique ID of the transfer

Response

Code: 200
Description: Returns details of the transfer

Example response

{
  "id": "7fb02323-969a-4936-94ea-86b8773ff1a2",
  "type": "external",
  "amount": 100,
  "transferTitle": "Bank transfer",
  "destinationIban": "LT601010012345678901",
  "receiverFirstName": "John",
  "receiverLastName": "Doe",
  "status": "SUCCESSFUL",
  "currency": "eur",
  "fee": 10,
  "createdAt": "2024-01-01T12:34:56Z",
  "user": {
    "externalUserId": "8bdd8c8a-e9b7-475e-9690-8a34e8b78dab",
    "email": "Giovani34@yahoo.com",
    "firstName": "Will",
    "lastName": "Hahn",
    "address": "0294 Greenholt Burgs",
    "city": "Wilfredchester",
    "country": "BM",
    "documentType": "id",
    "documentNumber": "109314",
    "pesel": null,
    "birthCountry": null,
    "birthDate": null
  }
}

 

Code: 400
Description: Partner not found

Example response

{
  "errorCode": "P418",
  "errorName": "partner-not-found"
}

 

Code: 404
Description: Sepa transfer not found

Example response

{
  "errorCode": "P428",
  "errorName": "sepa-transfer-not-found"
}