HEX
Server: nginx/1.24.0
System: Linux prod-btpayments-io 6.14.0-1018-aws #18~24.04.1-Ubuntu SMP Mon Nov 24 19:46:27 UTC 2025 x86_64
User: ubuntu (1000)
PHP: 8.3.19
Disabled: NONE
Upload Files
File: //home/user/downloads/BtPayments-platform/.docs/payment.md
Payment
===========================

## CoinPal.Payment : BtPayments

```jsonp
{
    "id": "01JB0MW2JRP3CQFGET01A114E8",         // BtPayments ID
    "requestId": "WOO127",                      // BtPayments 流水号
    "orderNo": "WOO127",                        // BtPayments 商户订单号
    "reference": "CWS4716A1919F15P",            // CoinPal 订单号

    // 請求的訂單幣種
    // CoinPalNotifyRecord->order_currency
    // Payment->order_currency_type
    "orderCurrency": "EUR",
    
    // 	請求的訂單金額
    // CoinPalNotifyRecord->order_amount
    // Patment->order_amount
    "orderAmount": "123.00",
    
    // 用戶支付的金額轉化成訂單幣種
    // CoinPalNotifyRecord->paid_order_amount
    // Patment->total_paid_amount
    "paidOrderAmount": "0.00000000",
    
    // 轉換為美元的「已支付訂單金額」(該欄位僅用於數據統計,不具有實際業務意義)
    // CoinPalNotifyRecord->paid_usdt
    // Patment->total_paid_amount_usdt
    "paidUsdt": "0",
    
    // 應付幣種
    // Patment->payer_paid_currency
    "dueCurrency": "KAS",
    
    // 	應付金額
    // Patment->payer_due_amount
    "dueAmount": "1033.80890904",
    
    // 實際支付幣種
    // Patment->payer_paid_currency
    "paidCurrency": "KAS",
    
    // 實際支付金額
    // Patment->payer_paid_amount
    "paidAmount": "0.00000000",
}
```

## CoinPal Notify Payload

### unpaid

```json
{
  "request": {
    "version": "2",
    "requestId": "WOO127",
    "merchantNo": "100005240",
    "orderNo": "WOO127",
    "reference": "CWS4716A1919F15P",
    "orderCurrency": "EUR",
    "orderAmount": "123.00",
    "paidOrderAmount": "0.00000000",
    "paymentMethod": "Crypto Payment",
    "selectedWallet": "9999",
    "dueCurrency": "KAS",
    "dueAmount": "1033.80890904",
    "network": null,
    "paidCurrency": "KAS",
    "paidAmount": "0.00000000",
    "paidUsdt": "0",
    "paidAddress": "kaspa:qyptjwhnykduvd36dmjylz5c42jl6l67m8kj6cap4c3dswsqfd42l7gss3rwt2s",
    "confirmedTime": "0",
    "status": "unpaid",
    "remark": null,
    "unresolvedLabel": null,
    "sign": "948ca7358a1ea2df78f539982ffdf95a5f38f7dfd8f92cfc803bcb42eba3b0cd",
    "id": "01JB0MW2JRP3CQFGET01A114E8"
  }
}
```

### failed

```json
{
  "request": {
    "version": "2",
    "requestId": "WOO125",
    "merchantNo": "100005240",
    "orderNo": "WOO125",
    "reference": "CWS4W169XUEE0Y71",
    "orderCurrency": "EUR",
    "orderAmount": "122.00",
    "paymentMethod": null,
    "selectedWallet": null,
    "network": null,
    "paidUsdt": "0",
    "confirmedTime": null,
    "status": "failed",
    "remark": null,
    "unresolvedLabel": null,
    "sign": "bd89e9615ddee144386685744da9d6a576395878d8f7ceb2b7dd41f4b9480165",
    "id": "01JAZ1FM0FQAD9JGPCJB11GH3F"
  }
}
```