Tổng quan

VinPayment API cho phép bạn tạo payment, theo dõi trạng thái và quản lý số dư — tất cả qua REST API đơn giản.

Quickstart

javascript
"color:#4a5568">// 1. Tạo payment
const res = await fetch('https:"color:#4a5568">//api.vinpayment.io/api/v1/payments', {
  method: 'POST',
  headers: {
    'x-api-key': 'vp_live_YOUR_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    orderId: 'order_001',
    token: 'USDC',
    chain: 'BSC',
    amount: 100,
  }),
})

"color:#4a5568">// 2. Nhận response
const { data } = await res.json()
"color:#4a5568">// → data.depositAddress: "0x35de..." hoặc "TXyz..." nếu chain=TRON
"color:#4a5568">// → data.checkoutUrl: "https://..." (hoặc redirect)

Flow thanh toán

1
Merchant gọi API
POST /api/v1/payments để tạo payment
2
Khách hàng chuyển tiền
Hiển thị depositAddress hoặc QR code cho khách
3
VinPayment detect
WebSocket monitor blockchain, phát hiện trong <2s
4
Webhook gọi
VinPayment POST đến webhookUrl của bạn với status COMPLETED
5
Tiền về hot wallet
Tự động forward về merchant hot wallet sau khi trừ phí

Môi trường

Production
https://api.vinpayment.io
Sandbox
https://sandbox.vinpayment.io