Overview

VinPayment API lets you create payments, track status, and manage balances — all via a simple REST API.

Quickstart

javascript
// 1. Create a payment
const res = await fetch('https://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,
  }),
})

// 2. Handle response
const { data } = await res.json()
// → data.depositAddress: "0x35de..." (or "TXyz..." if chain=TRON)

Payment flow

1
Merchant calls API
POST /api/v1/payments to create a payment
2
Customer sends funds
Show depositAddress or QR code to the customer
3
VinPayment detects
WebSocket monitors blockchain, detects in <2s
4
Webhook fires
VinPayment POSTs to your webhookUrl with status COMPLETED
5
Funds forwarded
Auto-forwarded to merchant hot wallet after fee deduction

Environments

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