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/fiat

⚙️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

payment_method_type
enum Required

Payment Method

amount
string Required

Amount

from_currency
string Required

Currency

to_currency
string Required

Currency

payer_bank_provider
string Required

Bank Transfer

payer_bank_account_number
string Required

Account Number

payer_bank_account_name
string Required

Account Name

payment_domain
string Required

โดเมนของระบบชำระเงิน (เช่น "https://app.wpayz.xyz" ห้ามเปลี่ยน)

url_return
string Required

Redirect URL

url_success
string Required

Redirect URL

url_failed
string Required

Redirect URL

additional_data
object Required

Metadata

Request Example

Terminal
curl --location 'https://testnet.trustsig.xyz/v1/payment/createInvoicePayment/fiat' \
--header 'Content-Type: application/json' \
--header 'x-api-key: $SIGNATURE_API_KEY' \
--data '{
    "order_id": "ORDER-199993491562",
    "order_user_reference": "12345",
    "payment_method_type": "PROMPTPAY_QR",
    "amount": "100.5",
    "from_currency": "THB",
    "to_currency": "THB",
    "payer_bank_provider": "SCB",
    "payer_bank_account_number": "4052512594",
    "payer_bank_account_name": "รณชิต ราโช",
    "payment_domain": "https://app.wpayz.xyz",
    "url_return": "http://example.com/home_page",
    "url_success": "http://example.com/success_page",
    "url_failed": "http://example.com/failed_page",
    "additional_data": {
        "description": "test create payment"
    }
}'

Response Example

200 OK
JSON Response
{
  "data": {
    "id": "f5f0e968-95aa-4939-9b97-a38ae03a3d68",
    "seq_num": 2206,
    "source_id": "wpayz",
    "slip_ref": null,
    "slip_payload": null,
    "slip_raw_signature": null,
    "slip_hash": null,
    "order_id": "ORDER-1759951096961",
    "order_user_reference": "12345",
    "order_auto_cancel_previous": true,
    "order_display_mode": "FIAT",
    "request_ip": null,
    "request_platform": "API",
    "payment_method_type": "PROMPTPAY_QR",
    "payment_provider": "EBANK",
    "invoice_type": "FIAT",
    "from_currency": "THB",
    "to_currency": "THB",
    "chain": "offchain",
    "network": "testnet",
    "to_wallet_id": null,
    "from_wallet_id": null,
    "address_type": "bank_account",
    "txid": "0x00",
    "address": "0x00",
    "from_address": null,
    "amount": "200.5",
    "payment_amount": 200.71,
    "payer_paid_currency": "THB",
    "payer_paid_amount": null,
    "payer_pay_network_fee": false,
    "payer_bank_provider": "SCB",
    "payer_bank_account_number": "4052512594",
    "payer_bank_account_name": "รณชิต ราโช",
    "merchant_promptpay_id": "0775568003223",
    "merchant_amount": 198.3,
    "merchant_number": "6123013742",
    "merchant_name": "บริษัท พีพีเคพี ไลฟ์ มาร์เก็ตติ้ง จำกัด",
    "merchant_provider": "SCB",
    "ebank_account_id": "7ca5907e-5446-4220-943e-aa17b67d36c9",
    "one_time_address": false,
    "is_multiple_order": true,
    "lifetime": 900,
    "expired_at": "2025-10-08T19:38:02.695Z",
    "fee_subtract": 0,
    "discount_percent": 0,
    "discount_amount": 0,
    "accuracy_percent": 0,
    "support_currencies": null,
    "except_currencies": null,
    "additional_data": {
      "description": "test create payment"
    },
    "auto_convert": false,
    "convert_to": "USDT",
    "payment_url": "https://demo.star777881.xyz/pay/f5f0e968-95aa-4939-9b97-a38ae03a3d68",
    "payment_qr": "00020101021229370016A0000006770101110213077556800322353037645802TH5406200.71630487E7",
    "payment_domain": "https://app.wpayz.xyz",
    "url_return": "http://example.com/home_page",
    "url_success": "http://example.com/success_page",
    "url_failed": "http://example.com/failed_page",
    "exchange_rate": 1,
    "exchange_rate_source": "COINGECKO",
    "tx_value": 0,
    "fx_rate": null,
    "payment_status": "PAYMENT_CHECKING",
    "payment_match_type": "EXACTLY",
    "is_completed": false,
    "status": "PENDING",
    "audit_by_user_id": null,
    "audit_time": null,
    "webhook_request_id": null,
    "sequence_time": "2025-10-08T19:23:02.773Z",
    "created_at": "2025-10-08T19:23:02.773Z",
    "updated_at": "2025-10-08T19:23:02.859Z",
    "owned_by_group": "5a5e6247-d7c3-4b86-b67d-dab9a052653d",
    "owned_by_group_parent": "1990a106-c97f-4c8f-b751-12879d931bdc",
    "organization_id": "5f5a3ae8-6fa4-47fd-bb4f-231935a32eb8",
    "agent_id": "c5688e45-584f-4d54-8fbe-b07179034917"
  },
  "success": true,
  "code": 0
}