API Documentation

Authorization: Bearer sk_live_YOUR_SECRET_KEY
Content-Type: application/json

https://api.zynexpay.com/v1

https://sandbox.zynexpay.com/v1

curl -X POST https://api.zynexpay.com/v1/payments \
  -H "Authorization: Bearer sk_live_YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1500.00,
    "currency": "THB",
    "description": "Order #1234",
    "callback_url": "https://yoursite.com/webhook",
    "return_url": "https://yoursite.com/thank-you",
    "customer_email": "customer@example.com",
    "metadata": {
      "order_id": "ORD-1234"
    }
  }'

{
  "id": "pay_a1b2c3d4e5f6",
  "object": "payment",
  "amount": 1500.00,
  "currency": "THB",
  "status": "pending",
  "description": "Order #1234",
  "checkout_url": "https://checkout.zynexpay.com/pay/pay_a1b2c3d4e5f6",
  "qr_code_url": "https://api.zynexpay.com/v1/qr/pay_a1b2c3d4e5f6.png",
  "expires_at": "2026-03-03T12:30:00Z",
  "created_at": "2026-03-03T12:00:00Z",
  "metadata": {
    "order_id": "ORD-1234"
  }
}

curl https://api.zynexpay.com/v1/payments/pay_a1b2c3d4e5f6 \
  -H "Authorization: Bearer sk_live_YOUR_SECRET_KEY"

{
  "id": "pay_a1b2c3d4e5f6",
  "object": "payment",
  "amount": 1500.00,
  "currency": "THB",
  "status": "succeeded",
  "paid_at": "2026-03-03T12:05:23Z",
  "payment_method": "promptpay",
  "fee": 3.75,
  "net": 1496.25
}

const zynexpay = require('zynexpay');
zynexpay.configure({ secretKey: 'sk_live_YOUR_KEY' });

const qr = await zynexpay.payments.createQR({
  amount: 350.00,
  currency: 'THB',
  description: 'สินค้า A',
  callback_url: 'https://yoursite.com/webhook'
});

console.log(qr.qr_code_url);
// => https://api.zynexpay.com/v1/qr/pay_xxx.png

const crypto = require('crypto');

app.post('/webhook', (req, res) => {
  const signature = req.headers['x-zynexpay-signature'];
  const payload = JSON.stringify(req.body);
  
  const expected = crypto
    .createHmac('sha256', 'whsec_YOUR_SIGNING_SECRET')
    .update(payload)
    .digest('hex');

  if (signature === expected) {
    // ✅ Verified — process the event
    const event = req.body;
    
    switch (event.type) {
      case 'payment.success':
        // อัปเดตสถานะ order
        break;
      case 'payment.failed':
        // แจ้ง admin
        break;
    }
    
    res.status(200).json({ received: true });
  } else {
    res.status(401).json({ error: 'Invalid signature' });
  }
});

{
  "error": {
    "code": "invalid_amount",
    "message": "Amount must be greater than 0",
    "param": "amount",
    "status": 400
  }
}