v1
latestOpenAPI 3.1.02026-07-226250251.5 KBCrypto Orchestration
Create a Payment
Create a new payment order for a supported integration type (ByBit, Kraken, OKX, Pass Through)
post/v1/transit/payment
Request body
Example request
{
"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",
"quote_id": "FIN_PROVIDED_QUOTE_ID",
"currency": "USDT",
"rail": "SOLANA",
"currency_type": "crypto",
"redirection_url": "https://example.com/redirect",
"success_url": "https://example.com/success",
"failed_url": "https://example.com/failed",
"order_expire_time": 3600,
"customer": {
"uid": "user_123",
"external_user_id": "ext_user_001",
"user_name": "John Li",
"register_time": 1739178959,
"kyc_country": "AUS"
},
"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"
},
"risk_info": {
"terminal_type": "APP"
}
},
"fin": {
"settlement_config": {
"settlement_via": "MARKET_ORDER",
"destination_details": {
"currency": "USDC",
"rail": "SOLANA"
}
},
"developer_fee": {
"fixed": "0.15",
"percentage": "2.5"
}
}
}Response
Payment created successfully
Example response
{
"data": {
"payment_id": "FIN_PROVIDED_UUID",
"integration_type": "BYBIT",
"provider_response": {
"pay_id": "01JN6AZVEMAC8H9SED6JES3QH8",
"terminal_type": "APP",
"expire_time": 1740751953,
"create_time": 1740748353,
"qr_content": "data:image/png;base64,/9j/2...f/Z"
}
}
}