Get Invoice Info

Retrieve invoice information by ID

GETGet Invoice Info
Endpoint URL
https://testnet.trustsig.xyz/v1/payment/info?id=05fc1385-c4cf-4c6a-8cef-a04f63c3d0cb

⚙️Authentication Status

⚠️ API Key is required for all requests Webhook Secret

🔑

Headers

x-api-key
Required

API Key is required for all requests

Accept-Language
Optional

Select Language

🔗

Parameters

invoice_id
string Required

Invoice ID

Parameters (Optional)

include_details
boolean Optional

Description

📝

Request Example

Terminal
curl --location 'https://testnet.trustsig.xyz/v1/payment/info?id=05fc1385-c4cf-4c6a-8cef-a04f63c3d0cb' \
--header 'x-api-key: YOUR_API_KEY_HERE' \
--header 'Accept-Language: th'

Response Example

200 OK
JSON Response
{
    "data": {
        "id": "05fc1385-c4cf-4c6a-8cef-a04f63c3d0cb",
        "seq_num": 1,
        "order_id": "ORDER-199993491562",
        "order_user_reference": "12345",
        "order_display_mode": "FIAT",
        "payment_method_type": "PROMPTPAY_QR",
        "payment_provider": "EBANK",
        "invoice_type": "FIAT",
        "from_currency": "THB",
        "to_currency": "THB",
        "chain": "offchain",
        "network": "testnet",
        "amount": "2.5",
        "payment_amount": 2.81,
        "payer_paid_currency": "THB",
        "payer_paid_amount": 2.81,
        "payer_pay_network_fee": false,
        "merchant_amount": 2.81,
        "merchant_number": "0105556189594",
        "merchant_name": "บจก. ฮาร์เล็ม เชคเกอร์ กรุ๊ป",
        "merchant_provider": "KBANK",
        "lifetime": 900,
        "expired_at": "2025-05-01T10:56:31.516Z",
        "payment_url": "https://app.wpayz.xyz/pay/05fc1385-c4cf-4c6a-8cef-a04f63c3d0cb",
        "payment_qr": "00020101021229370016A0000006770101110213010555618959453037645802TH54042.816304F9C5",
        "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",
        "webhook_url": "https://yourdomain.com/webhook",
        "exchange_rate": 1,
        "payment_status": "PAYMENT_PAID",
        "payment_match_type": "EXACTLY",
        "is_completed": true,
        "status": "COMPLETED",
        "paid_at": "2025-05-01T10:45:31.517Z",
        "created_at": "2025-05-01T10:41:31.517Z",
        "updated_at": "2025-05-01T10:45:31.517Z",
        "organization_id": "7686e9f3-1b6f-4100-9060-a0afb39b3541",
        "agent_id": "aacc3472-f3c3-49bb-9040-d5a6aff283bf",
        "transaction_history": [
            {
                "timestamp": "2025-05-01T10:41:31.517Z",
                "status": "PAYMENT_CHECKING",
                "description": "สร้างการชำระเงิน"
            },
            {
                "timestamp": "2025-05-01T10:45:31.517Z", 
                "status": "PAYMENT_PAID",
                "description": "ชำระเงินสำเร็จ",
                "amount_received": 2.81,
                "transaction_reference": "TXN123456789"
            }
        ]
    },
    "success": true,
    "message": "ดึงข้อมูลสำเร็จ",
    "timestamp": "2025-05-01T10:50:00.000Z"
}
📋

Response Parameters

id
string Optional

Invoice ID

order_id
string Optional

Reference ID

order_user_reference
string Optional

Customer Name

payment_method_type
enum Optional

Payment Method

amount
string Optional

Amount

payment_amount
number Optional

Amount

payer_paid_amount
number Optional

Amount

merchant_amount
number Optional

Withdrawal Amount

payment_status
enum Optional

Payment Status

is_completed
boolean Optional

Payment Status

status
string Optional

Status

payment_url
string Optional

Payment URL

payment_qr
string Optional

QR Code

webhook_url
string Optional

Webhook URL

expired_at
string Optional

Expires At

paid_at
string Optional

Paid At

created_at
string Optional

Created At

updated_at
string Optional

Updated At

transaction_history
array Optional

Transaction ID

📊

Payment Status Documentation

✅ Success

  • • PAYMENT_PAID - Completed
  • • PAYMENT_PAID_MANUALLY - Completed

⏳ Processing

  • • PAYMENT_CHECKING - Processing
  • • PAYMENT_PROCESSING - Processing
  • • PAYMENT_CONFIRM_CHECK - Processing

❌ Failed/Cancelled

  • • PAYMENT_FAILED - Failed
  • • PAYMENT_CANCELED - Cancelled
  • • PAYMENT_EXPIRED - Expired
💡

Example

🔍 Status

  • • Payment Status
  • • Payment Information
  • • Documentation

🔄 Webhook Setup

  • • Configure webhook endpoints to receive real-time payment notifications
  • • Verify Signature
  • • Settings
⚠️

Error

404 Not Found

Not Found

401 Unauthorized

Invalid API Key

429 Too Many Requests

Rate Limit Exceeded