Create Transfer From Quote

Create Offramp Transfer from Quote

post

/v0/customers/{customer_id}/offramp-transfer/quote/{quote_id}

Path parameters

customer_idstring · uuidRequired

The unique identifier of the customer

quote_idstring · uuidRequired

The unique identifier of the quote

Header parameters

Api-KeystringRequired

Your secret API key, available in the developer dashboard. Include this header on every request to authenticate your application.

Idempotency-KeystringRequired

Unique key to prevent duplicate requests

Body

You can provide either a reference to an existing external account ID or the complete bank account details for the destination.

or

Responses

201

Offramp transfer created successfully

application/json

idstring · uuidOptional

The unique identifier for the offramp transfer

statusstring · enumOptional

The current status of the offramp transfer

Example: processingPossible values:

amountstring · decimalOptional

The destination amount of the offramp transfer as a numeric string.

Example: 100.50Pattern: ^[0-9]+(\.[0-9]+)?$

source_tokenstring · enumOptional

The currency to be deposited

Example: usdcPossible values:

source_networkstring · enumOptional

The blockchain network for the source token

Example: polygonPossible values:

destination_currencystring · enumOptional

The currency for the destination

Example: usdPossible values:

destination_payment_railsstring · enumOptional

The rails type to be used for the bank transfer

Example: achPossible values:

transfer_purposestring · enumOptional

The purpose of the transfer

Possible values:

payment_referencestring · max: 35Optional

Free-text reference sent with the payment. Max 35 characters.

Example: Invoice 12345

destination_bank_accountone ofOptional

or

or

400

The quote can no longer be used to create a transfer. Possible reasons:

• Quote has expired — the quote is past its expire_at window
• Quote has already been used for a transfer — the quote was already consumed
• Quote not found

application/json

post/v0/customers/{customer_id}/offramp-transfer/quote/{quote_id}

POST /v0/customers/{customer_id}/offramp-transfer/quote/{quote_id} HTTP/1.1
Host: api.alignlabs.dev
Api-Key: text
Idempotency-Key: text
Content-Type: application/json
Accept: */*
Content-Length: 193

{
  "transfer_purpose": "charity",
  "payment_reference": "Invoice 12345",
  "destination_external_account_id": "123e4567-e89b-12d3-a456-426614174000",
  "documents": [
    {
      "file_id": "text",
      "description": "text"
    }
  ]
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "processing",
  "amount": "100.50",
  "source_token": "usdc",
  "source_network": "polygon",
  "destination_currency": "usd",
  "destination_payment_rails": "ach",
  "transfer_purpose": "charity",
  "payment_reference": "Invoice 12345",
  "destination_bank_account": {
    "bank_name": "text",
    "account_holder_type": "individual",
    "account_holder_first_name": "text",
    "account_holder_last_name": "text",
    "account_holder_business_name": "text",
    "account_holder_address": {
      "country": "US",
      "city": "San Francisco",
      "street_line_1": "580 Howard, Suite PH San Francisco",
      "postal_code": "94105"
    },
    "account_type": "iban",
    "iban": {
      "bic": "text",
      "iban_number": "text"
    }
  },
  "quote": {
    "deposit_network": "polygon",
    "deposit_token": "usdc",
    "deposit_blockchain_address": "0x1234567890abcdef1234567890abcdef12345678",
    "deposit_amount": "100.50",
    "source_amount": "100.50",
    "destination_amount": "98.00",
    "exchange_rate": "0.98",
    "fee_amount": "2.50",
    "deposit_transaction_hash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  }
}