Create recurring transfer

Create fixed wallet transfer channel. All incoming transfers of crypto will be forwarded to merchant IBAN.

Create a new recurring transfer

POST https://papi.swapin.com/api/recurring_transfers

Depending account configuration required fields may vary.

Request Body

Name	Type	Description
name*	String	Unique name of the recurring payment channel
coin*	String	Coin symbol
payer_type*	Numeric	1 for individual and 2 for business
payer_name*	String	Payer full name
payer_email	String	Payer contact email
payer_document_type*	Numeric	1 for ID card, 2 for passport
payer_document*	String	Payer document number
payer_birthdate*	Date	Payer date of birth (only for personal). Format YYYY-MM-DD
payer_birth_country*	String	Payer birth country code in ISO 3166 Alpha-2 (only for personal)
payer_address*	String	Payer residency address (Street and house, city, postal code, country)
payer_residency_country*	String	Payer residency country code in ISO 3166 Alpha-2
payer_code*	String	Payer registration number (only for business)
payer_external_id	String(50)	Payer ID in partner system.
client_reference	String	Reference to payment in Partner system

Response

200: OK

{
    "ok": true,
    "recurring_transfer": {
        "transfer_key": "42bvmih8uhpqd75s3326bie2upjt****",
        "status": "N",
        "status_time": "2025-03-21 09:49:29 +00:00",
        "created_time": "2023-09-15 08:23:57 +00:00",
        "name": "Customer #123456 USCD.ERC20 deposit",
        "currency": "EUR",
        "coin": "USDC.ERC20",
        "coin_address": "0xe7280b2bdef6ee6934f3f46b8481b182*********",
        "payer_type": 1,
        "payer_name": "John Smith",
        "payer_document_type": 1,
        "payer_document": "AA123456",
        "payer_birthdate": "1990-01-01",
        "payer_birth_country": "EE",
        "payer_address": "Värvi 5, Tallinn",
        "payer_residency_country": "EE",
        "payer_external_id": "b8ea1c5f-957c-4b08-a16e-c9fab443a72c",
        "client_reference": "14e1e975-f187-4ae1-a08e-350a1f131328"
    }
}    

422: Unprocessable Entity

{
    "message": "The given data was invalid.",
    "errors": {
        "coin": [
            "The coin field is required."
        ],        
    }
}

401: Unauthorized

{
    "message": "Please login"
}