Xpays

API Documentation

Documentation

API Reference & Integration Guide

API Available

Create Payment

Create a new payment request

POSTCreate Payment
Endpoint URL
https://testnet.trustsig.xyz/v1/payment/createInvoicePayment/crypto

⚙️Authentication Status

⚠️ API Key is required for all requests Webhook Secret

🔑

Headers

x-api-key
Required

API Key is required for all requests

Content-Type
Required

application/json

Accept-Language
Optional

Select Language

📖

Parameters (Request Body)

order_id
string Required

Reference ID

order_user_reference
string Required

Customer Name

one_time_address
boolean Required

สร้างที่อยู่่ใหม่สำหรับแต่ละคำสั่งซื้อ

amount
string Required

Amount

payer_pay_network_fee
boolean Required

ผู้ชำระเงินรับผิดชอบค่า network fee

from_currency
string Required

Currency (สกุลเงินต้นทาง)

to_currency
string Required

Currency (สกุลเงินปลายทาง)

chain
string Required

Blockchain network (tron, ethereum, bsc, etc.)

fee_subtract
number Required

ค่าธรรมเนียมที่หักออก (หน่วย: สตางค์)

discount_percent
number Required

เปอร์เซ็นต์ส่วนลด

payment_domain
string Required

โดเมนของระบบชำระเงิน

source_id
string Required

รหัสแหล่งที่มาของระบบ

Request Example

Terminal
curl --location 'https://testnet.trustsig.xyz/v1/payment/createInvoicePayment/crypto' \
--header 'Content-Type: application/json' \
--header 'x-api-key: $SIGNATURE_API_KEY' \
--data '{
    "order_id": "AD132131231214999969492",
    "order_user_reference": "123213",
    "one_time_address": true,
    "amount": "1000",
    "payer_pay_network_fee": false,
    "from_currency": "THB",
    "to_currency": "USDT",
    "chain": "tron",
    "fee_subtract": 100,
    "discount_percent": 0,
    "payment_domain": "https://demo.xpays.life",
    "source_id": "nowpay"
}'

Response Example

200 OK
JSON Response
{
  "data": {
    "id": "283ee6f5-3633-444d-91d3-926bdc7725b9",
    "seq_num": 2282,
    "source_id": "xpays",
    "slip_ref": null,
    "slip_payload": null,
    "slip_raw_signature": null,
    "slip_hash": null,
    "order_id": "AD132131231214999969492",
    "order_user_reference": "123213",
    "order_auto_cancel_previous": false,
    "order_display_mode": "FIAT",
    "request_ip": null,
    "request_platform": "API",
    "payment_method_type": "CRYPTO",
    "payment_provider": "TATUM",
    "invoice_type": "CRYPTO",
    "from_currency": "THB",
    "to_currency": "USDT",
    "chain": "tron",
    "network": "testnet",
    "to_wallet_id": "0820c9ef-11c7-4a31-b759-63c2a8e24f44",
    "from_wallet_id": null,
    "address_type": "crypto_address",
    "txid": null,
    "address": "TGKyyLrTgVbAS19gFawBKyw8haqwfSeHaW",
    "from_address": null,
    "amount": "1000",
    "payment_amount": 30.8299,
    "payer_paid_currency": "THB",
    "payer_paid_amount": null,
    "payer_pay_network_fee": false,
    "payer_bank_provider": null,
    "payer_bank_account_number": null,
    "payer_bank_account_name": null,
    "merchant_promptpay_id": null,
    "merchant_amount": 30.8299,
    "merchant_number": null,
    "merchant_name": null,
    "merchant_provider": null,
    "ebank_account_id": null,
    "one_time_address": true,
    "is_multiple_order": true,
    "lifetime": 3600,
    "expired_at": "2025-10-13T15:50:49.340Z",
    "fee_subtract": 100,
    "discount_percent": 0,
    "discount_amount": 0,
    "accuracy_percent": 0.5,
    "support_currencies": null,
    "except_currencies": null,
    "additional_data": {},
    "auto_convert": false,
    "convert_to": "USDT",
    "payment_url": "demo.nova777881.xyz/pay/283ee6f5-3633-444d-91d3-926bdc7725b9",
    "payment_qr": null,
    "payment_domain": "https://demo.xpays.life",
    "url_return": "",
    "url_success": "",
    "url_failed": "",
    "exchange_rate": 32.43599792403257,
    "exchange_rate_source": "COINGECKO",
    "tx_value": 0,
    "fx_rate": null,
    "payment_status": "PAYMENT_CHECKING",
    "payment_match_type": "RANGE",
    "is_completed": false,
    "status": "PENDING",
    "audit_by_user_id": null,
    "audit_time": null,
    "webhook_request_id": null,
    "sequence_time": "2025-10-13T14:50:49.422Z",
    "created_at": "2025-10-13T14:50:49.422Z",
    "updated_at": "2025-10-13T14:50:49.457Z",
    "owned_by_group": "2c321c8a-5d00-447b-8046-9fbe405707c2",
    "owned_by_group_parent": "0879d31d-1793-4011-a3d6-20fc3428d09c",
    "organization_id": "b8148919-1e7a-4c73-88ef-41677871d4ef",
    "agent_id": "6fa7c5ad-1fc3-41e6-aec4-f5b18201a1a2"
  },
  "success": true,
  "code": 0
}