Align API
  • Overview
    • About
    • Features & Use Cases
    • Blockchains
    • Countries & Currencies
    • Compliance
  • PRODUCTS
    • Cross-Chain Stablecoin Transfers
    • Cross-Chain Stablecoin Deposits
    • Fiat To Stablecoin (On-Ramp)
    • Stablecoin To Fiat (Off-Ramp)
    • Yield Generating Stablecoins
  • Align API
    • Customers
      • Create Customer
      • Get Customer
      • Fetch Customers
      • Create KYC Session
      • Share Individual KYC
    • Cross Chain Transfers
      • [Create] Cross-Chain Transfer
      • [Complete] Cross-Chain Transfer
      • [Get] Cross-Chain Transfer
      • [Create] Permanent Route Address
      • [Get] Permanent Route Address
      • [List] Permanent Route Addresses
    • Offramp Transfers
      • Create Offramp Transfer
      • Complete Offramp Transfer
      • Get Offramp Transfer
    • Onramp Transfers
      • Create Onramp Transfer
      • Get Onramp Transfer
    • Developer
      • Get Developer Fees
      • Update Developer Fees
    • Files
      • Upload File
    • Virtual Accounts
      • Create Virtual Account
      • Get Virtual Account
      • Get All Virtual Accounts
  • FEes
    • Developer Fees
    • Align Fees
  • Legal
    • Terms & Conditions
    • Privacy Policy
  • Guides
    • Create customer
Powered by GitBook
On this page
  1. Align API
  2. Onramp Transfers

Create Onramp Transfer

PreviousOnramp TransfersNextGet Onramp Transfer

Last updated 1 month ago

Create new Onramp Transfer

post

Creates onramp transfer and returns deposit information

Path parameters
customer_idstringRequired

The unique identifier of the customer

Header parameters
AuthorizationstringRequired

Token for authentication

Body
amountstring · decimalRequired

The amount of the onramp transfer as a numeric string

Pattern: ^[0-9]+(\.[0-9]+)?$
source_currencystring · enumRequired

The currency to be deposited

Possible values:
source_railsstring · enumRequired

The deposit rails to be used for the transaction

Possible values:
destination_networkstring · enumRequired

The blockchain network for the destination

Possible values:
destination_tokenstring · enumRequired

The token for the destination

Possible values:
destination_addressstringRequired

The blockchain address where the funds will be sent

Responses
201
Successful onramp transfer initiation response
application/json
post
POST /v0/customers/{customer_id}/onramp-transfer HTTP/1.1
Host: api.alignlabs.dev
Authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 152

{
  "amount": "text",
  "source_currency": "usd",
  "source_rails": "swift",
  "destination_network": "polygon",
  "destination_token": "usdc",
  "destination_address": "text"
}
201

Successful onramp transfer initiation response

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "pending",
  "amount": "text",
  "source_currency": "usd",
  "source_rails": "ach",
  "destination_network": "polygon",
  "destination_token": "usdc",
  "destination_address": "text",
  "quote": {
    "deposit_rails": "ach",
    "deposit_currency": "usd",
    "deposit_bank_account": {
      "bank_name": "text",
      "bank_address": "text",
      "account_beneficiary_type": "individual",
      "account_beneficiary_name": "text",
      "account_type": "us",
      "iban": {
        "bic": "text",
        "iban_number": "text"
      }
    },
    "deposit_amount": "text",
    "deposit_message": "text",
    "fee_amount": "text"
  }
}