รับเงิน (Billing)
Subscriptions
เก็บเงินรายเดือน/ปี — หักบัตรอัตโนมัติ หรือออกบิลให้จ่ายด้วย PromptPay (invoice) + portal ให้ลูกค้าจัดการเอง
เชื่อมต่อ
key ถูกเก็บใน httpOnly cookie ฝั่ง server — JavaScript ในเบราว์เซอร์อ่านไม่ได้ · สร้าง test key ที่ Dashboard → API keys
ลองยิง — กด Run ยิงจริง (test mode)
Subscription (PromptPay invoice)
เขียนสมัครสมาชิกรายเดือนแบบออกบิลให้จ่ายผ่าน PromptPay — หักบัตรไม่ได้ก็เก็บเงินได้
Customer portal
เขียนจัดการสมาชิก: ดูบิล/บัตร, ยกเลิกเมื่อจบรอบ แล้ว resume
โค้ด & API
สร้าง subscription ให้ลูกค้า · auto_charge ต้องมี payment_method, invoice จะออกบิลให้จ่าย (PromptPay ได้)
Headers
AuthorizationRequiredstring
Bearer sk_test_/sk_live_
Body
customerRequiredstring
customer id
priceRequiredstring
recurring price id
collection_methodstring
auto_charge | invoice (ดีฟอลต์ auto_charge)
payment_methodstring
จำเป็นสำหรับ auto_charge
curl -X POST https://api.heysub.co/v1/subscriptions \
-H "Authorization: Bearer sk_test_xxx" \
-H "Heysub-Version: 2026-09-01" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"customer":"cus_xxx","price":"price_xxx","collection_method":"invoice"}'{
"id": "sub_01J9X",
"status": "pending_first_payment",
"collection_method": "invoice",
"current_period_end": 1792842091
}ยกเลิกเมื่อจบรอบ (ดีฟอลต์) — ส่ง ?at_period_end=false เพื่อยกเลิกทันที
Headers
AuthorizationRequiredstring
Bearer sk_test_/sk_live_
Query
at_period_endboolean
false = ยกเลิกทันที (ไม่คืนเงิน)
curl -X POST https://api.heysub.co/v1/subscriptions/{id}/cancel \
-H "Authorization: Bearer sk_test_xxx" \
-H "Heysub-Version: 2026-09-01"{
"id": "sub_01J9X",
"status": "active",
"cancel_at_period_end": true
}