Create a Payment

curl --request POST \
  --url https://sandbox.api.fin.com/v1/transit/payment \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "integration_type": "BYBIT",
  "order_info": {
    "merchant_name": "PayPal",
    "client_id": "client_001",
    "payment_type": "E_COMMERCE",
    "merchant_trade_no": "841e4ba2-1234-5678-9abc-a2a45de7bd00",
    "order_amount": "100.00",
    "currency": "USDT",
    "currency_type": "crypto",
    "success_url": "https://example.com/success",
    "failed_url": "https://example.com/failed",
    "order_expire_time": 3600,
    "goods": [
      {
        "shopping_name": "test good1",
        "mcc_code": "1520",
        "goods_name": "test1",
        "goods_detail": "First product"
      }
    ],
    "env": {
      "terminal_type": "APP",
      "device": "iPhone 15",
      "browser_version": "iOS 17.0 Safari",
      "ip": "192.168.0.1"
    }
  },
  "fin": {
    "settlement_config": {
      "settlement_via": "MARKET_ORDER",
      "destination_details": {
        "wallet_address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
        "currency": "USDC",
        "rail": "SOLANA"
      }
    }
  }
}
'

{
  "data": {
    "payment_id": "FIN_PROVIDED_UUID",
    "integration_type": "BYBIT",
    "provider_response": {
      "pay_id": "01JN6AZVEMAC8H9SED6JES3QH8",
      "terminal_type": "APP",
      "expire_time": 1740751953,
      "create_time": 1740748353,
      "checkout_link": "",
      "qr_content": "data:image/png;base64,/9j/2...f/Z"
    }
  }
}

{
  "message": "Authentication failed"
}

{
  "error": {
    "code": 422,
    "type": "FIN_ERROR",
    "message": "One or more fields are invalid",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "code": 500104,
    "type": "PROVIDER_ERROR",
    "message": "Balance not Available",
    "details": [
      {}
    ]
  }
}

POST

transit

payment

curl --request POST \
  --url https://sandbox.api.fin.com/v1/transit/payment \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "integration_type": "BYBIT",
  "order_info": {
    "merchant_name": "PayPal",
    "client_id": "client_001",
    "payment_type": "E_COMMERCE",
    "merchant_trade_no": "841e4ba2-1234-5678-9abc-a2a45de7bd00",
    "order_amount": "100.00",
    "currency": "USDT",
    "currency_type": "crypto",
    "success_url": "https://example.com/success",
    "failed_url": "https://example.com/failed",
    "order_expire_time": 3600,
    "goods": [
      {
        "shopping_name": "test good1",
        "mcc_code": "1520",
        "goods_name": "test1",
        "goods_detail": "First product"
      }
    ],
    "env": {
      "terminal_type": "APP",
      "device": "iPhone 15",
      "browser_version": "iOS 17.0 Safari",
      "ip": "192.168.0.1"
    }
  },
  "fin": {
    "settlement_config": {
      "settlement_via": "MARKET_ORDER",
      "destination_details": {
        "wallet_address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
        "currency": "USDC",
        "rail": "SOLANA"
      }
    }
  }
}
'

{
  "data": {
    "payment_id": "FIN_PROVIDED_UUID",
    "integration_type": "BYBIT",
    "provider_response": {
      "pay_id": "01JN6AZVEMAC8H9SED6JES3QH8",
      "terminal_type": "APP",
      "expire_time": 1740751953,
      "create_time": 1740748353,
      "checkout_link": "",
      "qr_content": "data:image/png;base64,/9j/2...f/Z"
    }
  }
}

{
  "message": "Authentication failed"
}

{
  "error": {
    "code": 422,
    "type": "FIN_ERROR",
    "message": "One or more fields are invalid",
    "details": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "code": 500104,
    "type": "PROVIDER_ERROR",
    "message": "Balance not Available",
    "details": [
      {}
    ]
  }
}

Creates a payment order through the ByBit integration for USDT to PYUSD conversion. The payment flow supports QR code and e-commerce payment types with automatic settlement to a specified wallet address. Conditional Field Rules:

Either order_info.order_amount or order_info.quote_id must be provided, but not both.
When order_info.quote_id is not provided, order_info.order_amount and the fin object are required.
When order_info.quote_id is provided, order_info.order_amount and the fin object must not be included.
Providing both results in a 422 error.

Provider Error Codes: The 428 response code is a placeholder. When errors occur from the payment provider (ByBit), the original status code will be forwarded.

Authorizations

Authorization

string

header

required

Bearer token authentication. Obtain token from Issue a Token endpoint

Body

application/json

integration_type

enum<string>

required

Integration provider type.

Available options:

BYBIT,

PASS_THROUGH,

KRAKEN,

OKX

Example:

"BYBIT"

order_info

object

required

Show child attributes

fin

object

Required when quote_id is not provided.

Show child attributes

Response

Payment created successfully

data

object

Show child attributes

⌘I

Authentication

Customers

Beneficiaries

Transactions

Balances

Virtual Accounts

Fees & FX Rates

Catalogue

Crypto Orchestration

Webhooks

Create a Payment

Authorizations

Body

Response