CXYZ Payment Gateway API

Integrasikan pembayaran QRIS ke aplikasi kamu sendiri. Semua request butuh API key yang bisa kamu generate di halaman Profil.

Kirim API key kamu lewat header X-API-Key di setiap request. Jangan pernah expose API key ini di kode frontend/client-side.

Base URLhttps://cxyz-gateway.vercel.app/api/v1

POST/api/v1/create-payment

Membuat payment baru berupa QRIS. Nominal yang diminta akan ditambah biaya admin unik (Rp 50–56) supaya QRIS tetap unik walau nominal sama, tapi saldo yang masuk ke akun kamu tetap sesuai nominal asli yang diminta.

Request Body

Field	Tipe	Wajib	Keterangan
`amount`	integer	Ya	Nominal payment dalam Rupiah, minimal 1000

Contoh Request

curl -X POST https://cxyz-gateway.vercel.app/api/v1/create-payment \
  -H "X-API-Key: crzx-key-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"amount": 50000}'

Contoh Response

{
  "success": true,
  "payment_id": "CXa1b2c3d4e5f6g7",
  "amount": 50000,
  "unique_fee": 53,
  "billed_amount": 50053,
  "qris_image": "https://...",
  "payment_link": "https://...",
  "expired_at": "2026-07-10T15:30:00.000Z",
  "status": "pending"
}

Tampilkan qris_image ke pembayar. Setelah pembayar bayar sejumlah billed_amount, gunakan endpoint Check Status untuk mengecek apakah sudah lunas.

Error Response

Semua error mengembalikan format yang sama:

{
  "success": false,
  "message": "Deskripsi error di sini"
}

HTTP Status	Keterangan
`400`	Request tidak valid (parameter kurang/salah format)
`401`	API key tidak valid atau tidak dikirim
`404`	Payment tidak ditemukan
`500`	Kesalahan di server, coba lagi beberapa saat