How It Works

To use our On & Off Ramp feature, first set up your bank account. This is essential for generating quotes and executing On & Off-ramp transactions. Ensure this account corresponds to the traditional bank you wish to On-Ramp from and Off-Ramp to.

Before You Begin

Make sure you've created an Account Holder and noted the id attribute.

Create a Bank Account

📘
Note the response's bank account id for future use.

POST https://sandbox.conduit.financial/bank-accounts

Replace the Account Holder id with your noted one.

{
  "data": {
    "type": "bank-account",
    "attributes": {
        "accountNumber": "85683471",
        "routingCode": "037",
        "bankName": "Santander",
        "accountType": "checking",
        "nameOnBankAccount": "John Marvin Smith",
        "bicSwiftCode": "",
        "country": "CL",
        "currency": "CLP"
    },
    "relationships": {
        "account-holders":{
            "data": [{
                "type": "account-holder", 
                "id": "id:ahl:2J8Ocs7KFZJt3CMPi9f0x8UCCQ0"
            }]
        }
    }
  }
}

{
    "data": {
        "id": "id:bank-account:2U2IU0chv96O6V6mdDiRGSwCSfV",
        "type": "bank-account",
        "attributes": {
            "id": "id:bank-account:2U2IU0chv96O6V6mdDiRGSwCSfV",
            "bankName": "Santander",
            "nameOnBankAccount": "John Marvin Smith",
            "accountType": "checking",
            "accountNumber": "85683471",
            "routingCode": "037",
            "bicSwiftCode": "",
            "country": "CHL",
            "currency": "CLP"
        },
        "relationships": {
            "accountHolders": {
                "links": {
                    "related": "/bank-accounts/id:bank-account:2U2IU0chv96O6V6mdDiRGSwCSfV",
                    "self": "/bank-accounts/id:bank-account:2U2IU0chv96O6V6mdDiRGSwCSfV/relationships/account-holders",
                    "first": "/bank-accounts/id:bank-account:2U2IU0chv96O6V6mdDiRGSwCSfV/relationships/account-holders"
                },
                "data": [
                    {
                        "id": "id:ahl:2J8Ocs7KFZJt3CMPi9f0x8UCCQ0",
                        "type": "account-holder"
                    }
                ]
            }
        }
    }
}

📘
For routingCode, validation is currently manual. Ensure you follow the guidelines specified for each currency. There's no standard ISO for this. Users typically obtain it from their bank.

Routing Code Guidelines per Currency:

ARS: Not Required
BRL: Bank Code + Agency Code
CLP: Bank Code
COP: Bank Code
MXN: Not Required
PEN: Bank Code