---
title: Auto top-up
description: เติมเงินในวอลเล็ตของลูกค้าโดยอัตโนมัติจากบัตรหรือบัญชี PayPal ที่บันทึกไว้ — รองรับโหมดตามการใช้งานจริงและโหมดคงที่, ขีดจำกัดส่วนกลาง และการจัดการความผิดพลาด
url: https://nexcmp.com/th/docs/billing/auto-top-up/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Auto top-up {#auto-top-up}

> **ตำแหน่งในหน้าผู้ดูแลระบบ:** Finance › Payment channels › Fees & limits (`/payments/fees`), การ์ด **Wallet & top-up (Billing › Policy)**, ส่วน **Auto top-up (Stripe / PayPal)** **ตำแหน่งในพอร์ทัลลูกค้า:** Billing › Settings (`/billing?settings=1`)

## What it does {#what-it-does}

เมื่อยอดคงเหลือในวอลเล็ตของลูกค้าลดต่ำเกินไป NexCMP จะทำการเรียกเก็บเงินจาก [ saved payment method ](https://nexcmp.com/th/docs/billing/saved-payment-methods/) และเติมเครดิตเข้าวอลเล็ต เพื่อให้บริการที่กำลังทำงานอยู่ไม่ถูกระงับเนื่องจากเงินหมด โดยจะมีเบื้องหลังการทำงานคอยตรวจสอบลูกค้าที่เปิดใช้งานทั้งหมด **ทุกๆ 5 นาที**

## ข้อกำหนด {#requirements}

| Item | Requirement |
|---|---|
| ช่องทาง | กำหนดค่า [Stripe](https://nexcmp.com/th/docs/billing/stripe/) และ/หรือ [PayPal](https://nexcmp.com/th/docs/billing/paypal/) แล้ว |
| Saved method | ลูกค้ามีบัตรหรือบัญชี PayPal ที่บันทึกไว้ |
| ไซต์ | เว็บไซต์หลัก หรือเว็บไซต์ตัวแทนจำหน่ายที่มีช่องทาง Stripe/PayPal ซึ่งรวบรวมโดยแพลตฟอร์ม |
| Global switch | **Auto top-up enabled** เปิดอยู่ (ค่าเริ่มต้นคือเปิด) |

## วิธีการทำงาน {#how-it-works}

หลังจากที่ลูกค้าทำการ **เติมเงินครั้งแรกผ่าน Stripe หรือ PayPal** เซิร์ฟเวอร์จะบันทึกวิธีชำระเงินและเปิดใช้งานการเติมเงินอัตโนมัติในโหมด **By usage** ให้ — เฉพาะในกรณีที่ลูกค้าไม่เคยตั้งค่าการเติมเงินอัตโนมัติด้วยตนเอง ไม่มีช่องให้ติ๊กเพิ่มเติมบนหน้าจอฝากเงิน โดยเซิร์ฟเวอร์จะบันทึกเวลา, ที่อยู่ IP และวิธีชำระเงินไว้เป็นหลักฐาน หากลูกค้าปิดการเติมเงินอัตโนมัติในภายหลัง ระบบจะไม่เปิดใช้งานใหม่อีกเอง

| โหมด | เงื่อนไขการเรียกเก็บ (เมื่อยอดเงินคงเหลือต่ำกว่า ...) | จำนวนเงินที่เรียกเก็บ |
|---|---|---|
| **By usage** (ค่าเริ่มต้นหลังการเติมเงินครั้งแรก) | ค่าใช้จ่ายในการรันบริการสำหรับ 24 ชั่วโมงถัดไป (VM แบบคิดตามชั่วโมงบวกกับการต่ออายุแบบชำระล่วงหน้าที่จะครบกำหนดใน 24 ชั่วโมง) แต่จะไม่ต่ำกว่า **$5** | ต้นทุน 24 ชั่วโมงปัดเศษขึ้นเป็นจำนวนเต็มดอลลาร์ อย่างน้อยเท่ากับ [minimum top-up](https://nexcmp.com/th/docs/billing/minimum-top-up/) อย่างมากไม่เกิน maximum top-up และวงเงินจำกัดรายวัน |
| **Fixed amount** | เกณฑ์ที่ลูกค้ากำหนดเอง ($1 ถึง $500) | จำนวนเงินที่ลูกค้ากำหนดเอง (ตั้งแต่ minimum top-up ถึง $1,000 และมากกว่าเกณฑ์ที่กำหนด) |

หากไม่มีบริการที่กำลังทำงานอยู่และอยู่ในโหมด **By usage** จะไม่มีการเรียกเก็บเงิน

ยอดเงินคงเหลือที่นำมาเทียบกับเกณฑ์คือ **เงินสดจริงในกระเป๋าเงิน** เครดิตบริการจากโค้ดส่วนลดจะถูกแยกเก็บไว้ต่างหากและไม่นำมานับรวม (ดูที่ [Promotions](https://nexcmp.com/th/docs/billing/promotions/))

ค่าธรรมเนียมจะได้รับการจัดการเหมือนการเติมเงินปกติ: หากเปิด **Customer pays top-up fee** บัตรจะถูกหักเงินตามจำนวนรวมค่าธรรมเนียมและกระเป๋าเงินจะได้รับเงินเต็มจำนวน; หากปิด กระเป๋าเงินจะได้รับเงินจำนวนที่หักค่าธรรมเนียมแล้ว

## กำหนดค่าขีดจำกัดส่วนกลาง {#configure-the-global-limits}

1. เปิด **Finance › Payment channels › Fees & limits** (`/payments/fees`)
2. ในหัวข้อ **Auto top-up (Stripe / PayPal)** ให้ตั้งค่า:

   | การตั้งค่า | ค่าเริ่มต้น | ช่วง | ความหมาย |
   |---|---|---|---|
   | Auto top-up enabled | เปิด | เปิดหรือปิด | การปิดจะหยุดการเรียกเก็บเงินเบื้องหลังทั้งหมดทันที |
   | เกณฑ์การเติมเงินอัตโนมัติเริ่มต้น (USD, สำรองสำหรับโหมดคงที่) | $5.00 | $0 ถึง $10,000 | ใช้เป็นเกณฑ์เริ่มต้นในโหมด Fixed amount เท่านั้น |
   | จำนวนครั้งการเติมเงินอัตโนมัติสูงสุดต่อ 24 ชม. ต่อลูกค้าหนึ่งราย | 3 | 1 ถึง 50 | นับรวมความพยายามที่สำเร็จและที่อยู่ระหว่างดำเนินการ |
   | ขีดจำกัดยอดเติมเงินอัตโนมัติสูงสุดต่อ 24 ชม. ต่อลูกค้าหนึ่งราย (USD) | $500.00 | $0 ถึง $1,000,000 | ยอดรวมของการเรียกเก็บเงินอัตโนมัติภายในช่วงเวลา 1 วันที่ผ่านมา |

3. คลิก **Save Wallet & top-up**

![ส่วนเติมเงินอัตโนมัติของหน้าค่าธรรมเนียมและขีดจำกัด พร้อมสวิตช์ส่วนกลางและขีดจำกัดรายวัน](https://nexcmp.com/th/docs/images/billing/auto-top-up-01-limits.webp)

## สิ่งที่ลูกค้าเห็น {#what-the-customer-sees}

1. ในพอร์ทัล ลูกค้าจะเปิด **Billing** และคลิก **Settings**
2. แผงควบคุมจะแสดงวิธีชำระเงินที่บันทึกไว้, สวิตช์เปิด/ปิด, โหมด (**By usage** หรือ **Fixed amount**), การใช้งานปัจจุบันโดยประมาณ, การเรียกเก็บเงินครั้งถัดไป และ **Recent automatic top-ups**
3. การเปลี่ยนไปใช้โหมด **Fixed amount** จะช่วยให้พวกเขาสามารถระบุเกณฑ์และจำนวนเงินได้ การปิดสวิตช์จะหยุดการเรียกเก็บเงิน

![การตั้งค่าการเรียกเก็บเงินของลูกค้าพร้อมการเติมเงินอัตโนมัติในโหมด By usage และรายการเติมเงินอัตโนมัติล่าสุด](https://nexcmp.com/th/docs/images/billing/auto-top-up-02-portal.webp)

## ตรวจสอบ {#verify}

1. ในฐานะลูกค้าทดสอบ ให้ทำการเติมเงินครั้งแรกด้วยบัตรทดสอบ ([Stripe](https://nexcmp.com/th/docs/billing/stripe/#verify)) เปิด **Billing › Settings**: จะพบว่าการเติมเงินอัตโนมัติเปิดอยู่
2. รัน VM ขนาดเล็กเพื่อให้มีการใช้งาน และลดค่ายอดเงินคงเหลือให้อยู่ต่ำกว่าเกณฑ์ (ตัวอย่างเช่น ใช้ **Customers › customer › Credit / debit**)
3. ภายในเวลาประมาณ 5 นาที จะมีการเรียกเก็บเงินเกิดขึ้น ในการ์ด **Overview › Payment** ของลูกค้า **Auto top-up history** จะแสดงความพยายามที่มีสถานะเป็น *Done* และมีการส่งการแจ้งเตือน *Top-up received*

## ขีดจำกัดและหมายเหตุ {#limits-notes}

- **การหักเงินหนึ่งครั้งต่อหนึ่งรอบการลดลง** หลังจากหักเงินแล้ว งานจะรอจนกว่ายอดคงเหลือจะกลับมาสูงกว่าเกณฑ์หรือสิ้นสุดเวลาที่รอ: 1 ชั่วโมงหลังจากสำเร็จ, 24 ชั่วโมงหลังจากรายการรอดำเนินการ, 30 นาทีหลังจากเกิดข้อผิดพลาดของระบบ
- **ขีดจำกัดรายวัน** เมื่อถึงขีดจำกัดรายวันใดๆ จะไม่มีการหักเงินและจะมีการบันทึกบรรทัด *Daily limit reached* (อย่างน้อยที่สุดทุกๆ 6 ชั่วโมง)
- **ความล้มเหลว** บัตรที่ถูกปฏิเสธ, บัตรหมดอายุ หรือยอดเงินในบัญชีไม่เพียงพอจะถือเป็นความล้มเหลวของบัตร งานจะลองใหม่อีกครั้งหลังจาก 1 ชั่วโมง, จากนั้น 6 ชั่วโมง และ 24 ชั่วโมง **หลังจากบัตรล้มเหลวติดต่อกัน 3 ครั้ง ระบบจะปิดการเติมเงินอัตโนมัติ** และแจ้งเตือนลูกค้า (*Auto top-up failed*) การชำระเงินที่ต้องมีการยืนยันจากลูกค้า (ตัวอย่างเช่น 3-D Secure) จะไม่นับเป็นความล้มเหลว โดยจะแจ้งให้ลูกค้ายืนยัน
- **ไม่มีการหักเงินซ้ำ** การเรียกเก็บเงินแต่ละครั้งจะถูกดำเนินการแบบอะตอมิกต่อการลดลงต่ำกว่าเกณฑ์ และใช้คีย์การทำซ้ำ (idempotency key) ที่เกตเวย์
- **การลบบัตร** จะเป็นการปิดการใช้งานเติมเงินอัตโนมัติ
- **ตัวแทนจำหน่าย (Resellers)** หากตัวแทนจำหน่ายใช้ช่องทางการชำระเงินของตนเอง ลูกค้าจะไม่สามารถเปิดใช้งานการเติมเงินอัตโนมัติได้ (HTTP 403 `feature_disabled`)

## การแก้ Problme {#troubleshooting}

| อาการ | สาเหตุ | วิธีแก้ปัญหา |
|---|---|---|
| ลูกค้าไม่สามารถเปิดใช้งานได้: "Top up once with a card or PayPal" | ไม่มีวิธีชำระเงินที่บันทึกไว้ | ทำการเติมเงินผ่านบัตรหรือ PayPal หนึ่งครั้งก่อน |
| ข้อผิดพลาด `no_card` (422) | เกตเวย์ที่เลือกไม่มีวิธีชำระเงินที่บันทึกไว้ | เลือกเกตเวย์ที่มีวิธีชำระเงิน หรือบันทึกวิธีชำระเงิน |
| ข้อผิดพลาด `invalid_argument` ที่จำนวนเงิน | โหมดคงอยู่นอกช่วงที่อนุญาต | เกณฑ์ $1–$500, จำนวนเงินอยู่ระหว่างการเติมเงินขั้นต่ำและ $1,000, จำนวนเงินมากกว่าเกณฑ์ |
| ไม่มีการหักเงินแม้ว่ายอดคงเหลือจะต่ำ | ปิดสวิตช์ส่วนกลาง, ไม่มีบริการที่กำลังทำงานในโหมด By usage, ถึงขีดจำกัดรายวัน หรือการหักเงินครั้งก่อนยังรอดำเนินการอยู่ | ตรวจสอบสวิตช์, ประวัติ และขีดจำกัด |
| "ความพยายามล้มเหลวติดต่อกัน N ครั้ง — การเติมเงินอัตโนมัติจะปิดใช้งานหลังจาก 3 ครั้ง" | บัตรล้มเหลวซ้ำๆ | ลูกค้าเปลี่ยนบัตรใหม่ด้วยการฝากเงินครั้งใหม่ |
| สถานะ *Needs your confirmation* | ธนาคารต้องการการยืนยัน 3-D Secure | ลูกค้าทำการเติมเงินปกติให้เสร็จสิ้นหนึ่งครั้ง |