AdeePay

นักพัฒนา

เรียกครั้งเดียว callback ครั้งเดียว ลงบัญชีรายการเดียว

การเชื่อมต่อทั้งหมดคือ endpoint REST ที่คุณเซ็น callback ที่คุณตรวจ และสถานะที่ถามซ้ำได้เสมอ

สร้างการชำระเงิน

เซ็น JSON body ด้วย HMAC-SHA256 บน path — middleware ตัดคำนำหน้า /api ออกก่อนคำนวณ จึงต้องเซ็น /v2/payins ทั้งที่ POST ไปที่ /api/v2/payins

ตัวอย่างโค้ดใช้ api.example.com — endpoint จริงจะออกให้ตอน onboarding

create-payment.sh
curl -X POST https://api.example.com/v2/payins \
  -H "Content-Type: application/json" \
  -H "X-API-Key: <your-api-key>" \
  -H "X-Timestamp: <unix-timestamp>" \
  -H "X-Signature: <hmac-sha256-of-path>" \
  -d '{
    "merchant_ref_id": "unique-order-ref-id-2025001",
    "currency_code": "THB",
    "request_amount": 1000,
    "customer_id": "0198cbc6-fd02-7459-a671-78c306d0a1ad",
    "customer_account_id": "0198cbc7-35ec-7c8c-8994-d3ac3e7f5255",
    "redirect_url": "https://merchant.example.com/payment/success"
  }'
{
  "id": "0198cbff-db9b-7b6a-9f82-6a55fdfb6575",
  "merchant_ref_id": "unique-order-ref-id-2025001",
  "status": "pending",
  "request_amount": 1000,
  "paypage_url": "https://pay.example.com/pay/0198cbff-db9b-7b6a-9f82-6a55fdfb6575"
}

จัดการ webhook — ยืนยันตัวตนและกันซ้ำ

เราส่งซ้ำจนกว่า server คุณจะตอบ HTTP 200 ลายเซ็นคำนวณจาก raw body การเอา JSON ที่ parse แล้วมา stringify ใหม่จะไม่ตรง

อ้างอิง

ขอบเขต API

Endpointใช้ทำอะไร
/v2/payinsสร้างรายการรับเงิน (แนะนำ)
/v1/payins/:idอ่านรายการรับเงินรายการเดียว
/v2/payins/:id/cancelยกเลิกรายการที่ยังค้าง
/v1/payoutsสร้างรายการจ่ายออก
/v1/payouts/:idอ่านรายการจ่ายออกรายการเดียว
/v1/settlementsถอนเข้าบัญชีองค์กรตัวเอง
/v1/payins/:id/slipส่งสลิปการโอน
/me/balancesยอดคงเหลือแยกตามสกุลเงิน
/me/limitsวงเงินของคุณ
/me/issuesแจ้งและติดตามปัญหา

แซนด์บ็อกซ์

มี endpoint สำหรับ debug ของทั้งฝั่งรับเงินและจ่ายเงินแยกไว้ ให้ไล่ทดสอบการเชื่อมต่อได้ครบเส้นก่อนขึ้นจริง

endpoint จริงออกให้ตอน onboarding

สมัครบัญชีแล้วใบสมัครจะถูกตรวจก่อนเปิดใช้งาน — credential และ endpoint จริงจะออกให้เมื่อผ่านการอนุมัติ

ขอสิทธิ์เข้าใช้งาน