Skip to main content
POST
/
v1
/
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"
    }
  }
}
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
​
fin
object

Required when quote_id is not provided.

Response

Payment created successfully

​
data
object