Guides
Portal LoginTerms of ServiceSupport

Fiat On & Off-Ramp

Learn how to fund your account and facilitate exchanges between fiat currencies, using local payment methods, and stablecoins

Suggest Edits

Before You Begin

Make sure you've created an Account and recorded the allocationid for default_pool_usdc. Please also make sure you've created a Bank Account and recorded the id.

🚧

Contact Support For Ramp Access

For Sandbox or Live ramp access, please reach out to your Account Manager with the relevant Account ID(s) and Bank Account ID(s).

Fiat On-Ramp

In the following example, we will be exchanging Chilean Pesos (CLP) for USDC to fund your account.

1. Create 1000000 CLP <> USDC Quote

📘

Quotes are valid for 30 seconds. Please note the response's quote id and amount.

POST https://sandbox.conduit.financial/quotes

  • Replace account with your account id
{
  "data": {
    "attributes": {
      "account": "id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE",
      "source": {
        "assetType": "asset:fiat:CLP",
        "amount": "1000000000000"
      },
      "target": {
        "assetType": "asset:eth:USDC"
      }
    }
  }
}

{
  "data": {
    "id": "id:quote:2JHnGDjZputjFOCwHIVDNA4Uftr",
    "type": "quote",
    "attributes": {
      "account": "id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE",
      "source": {
        "assetType": "asset:fiat:CLP",
        "amount": "1000000000000"
      },
      "target": {
        "assetType": "asset:eth:USDC",
        "amount": "1239359400"
      },
      "expiresAt": "2022-12-22T21:17:17.276Z",
      "status": "open"
    }
  },
  "links": {
    "self": "/quotes/id:quote:2JHnGDjZputjFOCwHIVDNA4Uftr"
  }
}

2. Accept Quote

📘

After live Ramp access is enabled for you, use wlt:fiat:{Client ID} as the source for On-Ramp transactions. The transaction's destination can be a wallet address, pool, or allocation.

POST https://sandbox.conduit.financial/transactions

  • Replace quote with your generated quote id
  • Replace source with your Client id
  • Replace destination with your default_pool_usdc allocation id
  • Replace amount with the amount from the generated quote
{
  "data": {
    "attributes": {
      "quote": "id:quote:2JHnGDjZputjFOCwHIVDNA4Uftr",
      "source": "wlt:fiat:2IEdAlD1KKXLW7AEjCgmRsDzyxN",
      "destination": "id:allc:2J8OkA50iEKCUdAP64xbgU14Irf",
      "assetType": "asset:eth:USDC",
      "amount": "1239359400"
    }
  }
}

{
    "data": {
        "id": "id:trxn:2JHnLopbIRvx7a7KMzEYF7McDlv",
        "type": "transaction",
        "attributes": {
            "createdAt": "2022-12-22T21:17:04.338Z",
            "createdBy": "client",
            "effectiveDate": "2022-12-23",
            "amount": "1239359400",
            "source": "wlt:fiat:2IEdAlD1KKXLW7AEjCgmRsDzyxN",
            "destination": "id:allc:2J8OkA50iEKCUdAP64xbgU14Irf",
            "status": "pending",
            "assetType": "asset:eth:USDC",
            "quote": "id:quote:2JHnGDjZputjFOCwHIVDNA4Uftr"
        },
        "relationships": {
            "source": {
                "links": {
                    "self": "/transactions/id:trxn:2JHnLopbIRvx7a7KMzEYF7McDlv/relationships/source",
                    "related": "/transactions/id:trxn:2JHnLopbIRvx7a7KMzEYF7McDlv/source"
                },
                "data": {
                  "id": "wlt:fiat:2IEdAlD1KKXLW7AEjCgmRsDzyxN",
                  "type": "wallet"
                }
            },
            "destination": {
                "links": {
                    "self": "/transactions/id:trxn:2JHnLopbIRvx7a7KMzEYF7McDlv/relationships/destination",
                    "related": "/transactions/id:trxn:2JHnLopbIRvx7a7KMzEYF7McDlv/destination"
                },
                "data": {
                    "id": "id:allc:2J8OkA50iEKCUdAP64xbgU14Irf",
                    "type": "allocation"
                }
            },
            "quote": {
                "links": {
                    "self": "/transactions/id:trxn:2JHnLopbIRvx7a7KMzEYF7McDlv/relationships/quote",
                    "related": "/transactions/id:trxn:2JHnLopbIRvx7a7KMzEYF7McDlv/quote"
                },
                "data": {
                    "id": "id:quote:2JHnGDjZputjFOCwHIVDNA4Uftr",
                    "type": "quote"
                }
            }
        }
    }
}

3. Check Balance

The quoted USDC should now reflect in the account. Confirm this by checking the account balance.

📘

Expect a deliberate 10-minute delay for USDC deposits in the Sandbox, simulating our Live environment's settlement process. Explore how our Float Accounts can offer your users a near-instant experience.

GET https://sandbox.conduit.financial/accounts/id:acct:{your_account_id}

{
  "data": {
    "id": "id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE",
    "type": "account",
    "attributes": {
      "balances": {
        "available": [
          {
            "assetType": "asset:eth:USDC",
            "amount": "1239359400"
          }
        ],
        "pending": [
          {
            "assetType": "asset:eth:USDC",
            "amount": "0"
          }
        ]
      }
    },
    "relationships": {
      "account-holders": {
        "links": {
          "self": "/accounts/id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE/relationships/account-holders",
          "related": "/accounts/id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE/account-holders"
        },
        "data": [
          {
            "id": "id:ahl:2J8Ocs7KFZJt3CMPi9f0x8UCCQ0",
            "type": "account-holder"
          }
        ]
      },
      "allocations": {
        "links": {
          "self": "/accounts/id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE/relationships/allocations",
          "first": "/accounts/id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE/relationships/allocations",
          "next": null,
          "related": "/accounts/id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE/allocations"
        },
        "data": [
          {
            "id": "id:allc:2J8OkA50iEKCUdAP64xbgU14Irf",
            "type": "allocation"
          }
        ]
      },
      "wallets": {
        "links": {
          "self": "/accounts/id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE/relationships/wallets",
          "related": "/accounts/id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE/wallets"
        },
        "data": []
      }
    }
  },
  "included": [
    {
      "id": "id:allc:2J8OkA50iEKCUdAP64xbgU14Irf",
      "type": "allocation",
      "attributes": {
        "effectiveYieldRate": "0",
        "conduitTakeRate": "20",
        "clientTakeRate": "0",
        "poolId": "id:pool:2H1E3EPxcafvzFKOyoLUwO2PfcK",
        "poolYieldRate": "0",
        "accountId": "id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE",
        "poolName": "default_pool_usdc",
        "balances": {
          "available": [
            {
              "assetType": "asset:eth:USDC",
              "amount": "1239359400"
            }
          ],
          "pending": [
            {
              "assetType": "asset:eth:USDC",
              "amount": "0"
            }
          ],
          "accruedYield": [
            {
              "assetType": "asset:eth:USDC",
              "amount": "0"
            }
          ]
        }
      }
    }
  ]
}

Fiat Off-Ramp

In the following example, we will be exchanging USDC for Chilean Pesos (CLP).

1. Create 10 USDC <> CLP Quote

📘

Quotes are valid for 30 seconds. Please note the response's quote id and amount.

POST https://sandbox.conduit.financial/quotes

  • Replace account with your account id
  • Replace bank with your bank account id
{
  "data": {
    "attributes": {
      "account": "id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE",
      "bank": "id:bank-account:2U2IU0chv96O6V6mdDiRGSwCSfV",
      "source": {
        "assetType": "asset:eth:USDC",
        "amount": "10000000"
      },
      "target": {
        "assetType": "asset:fiat:CLP"
      }
    }
  }
}

{
  "data": {
    "id": "id:quote:2JHqkOy9Ww9TGeIpFNVjJ9oFHkd",
    "type": "quote",
    "attributes": {
      "account": "id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE",
      "bank": "id:bank-account:2U2IU0chv96O6V6mdDiRGSwCSfV",
      "source": {
        "assetType": "asset:eth:USDC",
        "amount": "10000000"
      },
      "target": {
        "assetType": "asset:fiat:CLP",
        "amount": "8393116000"
      },
      "expiresAt": "2022-12-22T21:45:57.908Z",
      "status": "open"
    }
  },
  "links": {
    "self": "/quotes/id:quote:2JHqkOy9Ww9TGeIpFNVjJ9oFHkd"
  }
}

2. Accept Quote

POST https://sandbox.conduit.financial/transactions

  • Replace quote with your generated quote id
  • Replace source with your default_pool_usdc allocation id
  • Replace destination with your bank account id
{
  "data": {
    "attributes": {
      "quote": "id:quote:2JHqkOy9Ww9TGeIpFNVjJ9oFHkd",
      "source": "id:allc:2JEtgy38BDntal10u4QtcKVTecr",
      "destination": "id:bank-account:2U2IU0chv96O6V6mdDiRGSwCSfV",
      "assetType": "asset:eth:USDC",
      "amount": "10000000"
    }
  }
}

{
    "data": {
        "id": "id:trxn:2JHqnKPOouVtf7dVYvBbGt4o96x",
        "type": "transaction",
        "attributes": {
            "createdAt": "2022-12-22T21:45:24.853Z",
            "createdBy": "client",
            "effectiveDate": "2022-12-23",
            "amount": "10000000",
            "source": "id:allc:2JEtgy38BDntal10u4QtcKVTecr",
            "destination": "id:bank-account:2U2IU0chv96O6V6mdDiRGSwCSfV",
            "status": "pending",
            "assetType": "asset:eth:USDC",
            "quote": "id:quote:2JHqkOy9Ww9TGeIpFNVjJ9oFHkd"
        },
        "relationships": {
            "source": {
                "links": {
                    "self": "/transactions/id:trxn:2JHqnKPOouVtf7dVYvBbGt4o96x/relationships/source",
                    "related": "/transactions/id:trxn:2JHqnKPOouVtf7dVYvBbGt4o96x/source"
                },
                "data": {
                    "id": "id:allc:2JEtgy38BDntal10u4QtcKVTecr",
                    "type": "allocation"
                }
            },
            "destination": {
                "links": {
                    "self": "/transactions/id:trxn:2JHqnKPOouVtf7dVYvBbGt4o96x/relationships/destination",
                    "related": "/transactions/id:trxn:2JHqnKPOouVtf7dVYvBbGt4o96x/destination"
                },
                "data": {
                    "id": "id:bank-account:2U2IU0chv96O6V6mdDiRGSwCSfV",
                    "type": "bank-account"
                }
            },
            "quote": {
                "links": {
                    "self": "/transactions/id:trxn:2JHqnKPOouVtf7dVYvBbGt4o96x/relationships/quote",
                    "related": "/transactions/id:trxn:2JHqnKPOouVtf7dVYvBbGt4o96x/quote"
                },
                "data": {
                    "id": "id:quote:2JHqkOy9Ww9TGeIpFNVjJ9oFHkd",
                    "type": "quote"
                }
            }
        }
    }
}

3. Check Balance

GET https://sandbox.conduit.financial/accounts/id:acct:{your_account_id}

{
  "data": {
    "id": "id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE",
    "type": "account",
    "attributes": {
      "balances": {
        "available": [
          {
            "assetType": "asset:eth:USDC",
            "amount": "1229359400"
          }
        ],
        "pending": [
          {
            "assetType": "asset:eth:USDC",
            "amount": "0"
          }
        ]
      }
    },
    "relationships": {
      "account-holders": {
        "links": {
          "self": "/accounts/id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE/relationships/account-holders",
          "related": "/accounts/id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE/account-holders"
        },
        "data": [
          {
            "id": "id:ahl:2J8Ocs7KFZJt3CMPi9f0x8UCCQ0",
            "type": "account-holder"
          }
        ]
      },
      "allocations": {
        "links": {
          "self": "/accounts/id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE/relationships/allocations",
          "first": "/accounts/id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE/relationships/allocations",
          "next": null,
          "related": "/accounts/id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE/allocations"
        },
        "data": [
          {
            "id": "id:allc:2J8OkA50iEKCUdAP64xbgU14Irf",
            "type": "allocation"
          }
        ]
      },
      "wallets": {
        "links": {
          "self": "/accounts/id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE/relationships/wallets",
          "related": "/accounts/id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE/wallets"
        },
        "data": []
      }
    }
  },
  "included": [
    {
      "id": "id:allc:2J8OkA50iEKCUdAP64xbgU14Irf",
      "type": "allocation",
      "attributes": {
        "effectiveYieldRate": "0",
        "conduitTakeRate": "20",
        "clientTakeRate": "0",
        "poolId": "id:pool:2H1E3EPxcafvzFKOyoLUwO2PfcK",
        "poolYieldRate": "0",
        "accountId": "id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE",
        "poolName": "default_pool_usdc",
        "balances": {
          "available": [
            {
              "assetType": "asset:eth:USDC",
              "amount": "1229359400"
            }
          ],
          "pending": [
            {
              "assetType": "asset:eth:USDC",
              "amount": "0"
            }
          ],
          "accruedYield": [
            {
              "assetType": "asset:eth:USDC",
              "amount": "0"
            }
          ]
        }
      }
    }
  ]
}

Updated about 1 year ago

What’s Next

Now that you know how to On and Off-ramp fiat, learn how to transfer funds and make payments.