Alipay+ โหมดร้านค้าแสดง QR (MPM)

รับชำระเงินในร้านค้าแบบออฟไลน์ผ่านผู้ใช้ Alipay+ ที่สแกน QR code ที่ร้านค้าสร้างขึ้นผ่านแอปพลิเคชันวอลเล็ตที่รองรับ

ภาพรวม

โหมดร้านค้าแสดง QR (C scan B) ช่วยให้ลูกค้าชำระเงินโดยการสแกน QR code ที่แสดงโดยร้านค้าที่เครื่องชำระเงิน ณ จุดขาย (POS) วิธีนี้เหมาะสำหรับการชำระเงินในร้านค้าที่ร้านค้าสร้าง QR code เฉพาะสำหรับแต่ละรายการธุรกรรม

คุณสมบัติหลัก:

• ✅ ชำระเงินในร้านค้า - เหมาะสำหรับร้านค้าปลีก ร้านอาหาร และร้านค้าทั่วไป
• ✅ หลายวอลเล็ต - รับชำระเงินจากวอลเล็ตพันธมิตร Alipay+ มากกว่า 12 ราย
• ✅ ชำระเงินรวดเร็ว - ลูกค้าสแกนและชำระเงินภายในไม่กี่วินาที
• ✅ ไม่ต้องใช้ฮาร์ดแวร์ - แสดง QR บนหน้าจอใดก็ได้หรือพิมพ์ออกมา
• ✅ ข้ามพรมแดน - รับชำระเงินจากนักท่องเที่ยวต่างชาติ

ภูมิภาคที่รองรับ

ภูมิภาค	สกุลเงิน	จำนวนขั้นต่ำ	จำนวนสูงสุด	เวอร์ชัน API
ประเทศไทย	THB	฿20.00	฿150,000.00	2017-11-02
สิงคโปร์	SGD	$1.00	$20,000.00	2017-11-02

วอลเล็ตที่รองรับ

วอลเล็ต	ประเทศไทย	สิงคโปร์
Alipay CN	✅	✅
Alipay HK	✅	✅
KakaoPay	✅	✅
GCash	✅	—
Touch 'n Go	✅	✅
TrueMoney	✅	—

วิธีการทำงาน

ขั้นตอนการชำระเงิน:

1. ร้านค้าสร้าง payment source กับ Omise
2. QR code แสดงบนเครื่อง POS
3. ลูกค้าเปิดแอปวอลเล็ต (GCash, KakaoPay ฯลฯ)
4. ลูกค้าสแกน QR code
5. ลูกค้ายืนยันการชำระเงินในแอป
6. ร้านค้าได้รับการยืนยันผ่าน webhook

ระยะเวลาดำเนินการโดยทั่วไป: 30 วินาที - 1 นาที

การใช้งาน

ขั้นตอนที่ 1: สร้าง Source

cURL

curl https://api.omise.co/sources \
  -u $OMISE_PUBLIC_KEY: \
  -d "amount=150000" \
  -d "currency=THB" \
  -d "type=alipayplus_mpm"

Node.js

const omise = require('omise')({
    secretKey: 'skey_test_YOUR_SECRET_KEY'
});

const source = await omise.sources.create({
    type: 'alipayplus_mpm',
    amount: 150000,
    currency: 'THB'
});

console.log('QR Code:', source.scannable_code.image.download_uri);

PHP

<?php
$source = OmiseSource::create([
    'type' => 'alipayplus_mpm',
    'amount' => 150000,
    'currency' => 'THB'
]);

echo "QR Code: " . $source['scannable_code']['image']['download_uri'];
?>

ขั้นตอนที่ 2: สร้าง Charge

curl https://api.omise.co/charges \
  -u $OMISE_SECRET_KEY: \
  -d "amount=150000" \
  -d "currency=THB" \
  -d "source=src_test_xxx"

ขั้นตอนที่ 3: แสดง QR Code

const qrCodeUrl = charge.source.scannable_code.image.download_uri;
// Display this QR code on your POS terminal

ขั้นตอนที่ 4: จัดการ Webhook

app.post('/webhooks/omise', (req, res) => {
    const event = req.body;

    if (event.key === 'charge.complete') {
        const charge = event.data;
        if (charge.status === 'successful') {
            // Payment successful - fulfill order
            console.log('Payment received!');
        }
    }

    res.status(200).send('OK');
});

วงจรชีวิตของ Charge

สถานะ	คำอธิบาย
pending	แสดง QR code แล้ว รอการชำระเงิน
successful	การชำระเงินสำเร็จ
failed	การชำระเงินล้มเหลวหรือถูกปฏิเสธ
expired	หมดเวลาการชำระเงิน (24 ชั่วโมง)

การคืนเงินและการยกเลิก

• ระยะเวลายกเลิก: จนถึง 16:15 UTC ของวันที่ทำรายการ
• ระยะเวลาคืนเงิน: ภายใน 1 ปีนับจากวันที่ทำรายการ
• คืนเงินบางส่วน: รองรับ

แนวทางปฏิบัติที่ดี

1. แสดงคำแนะนำที่ชัดเจน - แสดงว่ารับวอลเล็ตใดบ้าง
2. ตั้งเวลาหมดอายุที่เหมาะสม - แสดงตัวนับถอยหลังสำหรับการหมดอายุของ QR
3. จัดการ webhooks - อย่าพึ่งพาเฉพาะการกลับมาของลูกค้า
4. ทดสอบอย่างละเอียด - ทดสอบกับวอลเล็ตที่รองรับแต่ละตัว

คำถามที่พบบ่อย

โหมดร้านค้าแสดง QR (MPM) คืออะไร?

MPM หรือที่เรียกว่า "C scan B" (ลูกค้าสแกนร้านค้า) เป็นวิธีการชำระเงินในร้านค้าที่ร้านค้าแสดง QR code และลูกค้าสแกนด้วยแอปวอลเล็ต วิธีนี้เหมาะสำหรับสภาพแวดล้อมค้าปลีกที่มีเครื่อง POS

ลูกค้าสามารถใช้วอลเล็ตใดในการสแกน QR code ของฉันได้บ้าง?

ลูกค้าสามารถใช้วอลเล็ตพันธมิตร Alipay+ ใดก็ได้ รวมถึง: Alipay CN, Alipay HK, KakaoPay, GCash, Touch 'n Go และ TrueMoney วอลเล็ตที่ใช้ได้ขึ้นอยู่กับภูมิภาคของคุณ (ประเทศไทยหรือสิงคโปร์)

QR code มีอายุใช้งานนานเท่าไร?

QR code หมดอายุ 24 ชั่วโมงหลังจากสร้าง อย่างไรก็ตาม เพื่อประสบการณ์ลูกค้าที่ดีขึ้น เราแนะนำให้แสดงตัวนับถอยหลังและสร้าง QR code ใหม่สำหรับธุรกรรมที่ใช้เวลานานกว่าที่คาดไว้

ฉันสามารถยกเลิกหรือคืนเงินธุรกรรม MPM ได้หรือไม่?

ได้ คุณสามารถยกเลิกธุรกรรมได้จนถึง 16:15 UTC ของวันที่ทำรายการ การคืนเงิน (เต็มจำนวนหรือบางส่วน) รองรับภายใน 1 ปีนับจากธุรกรรมเดิม

ฉันต้องมีฮาร์ดแวร์พิเศษสำหรับ MPM หรือไม่?

ไม่ต้องการฮาร์ดแวร์พิเศษ คุณสามารถแสดง QR code บนหน้าจอใดก็ได้ (แท็บเล็ต จอภาพ โทรศัพท์) หรือแม้แต่พิมพ์ออกมา ลูกค้าใช้โทรศัพท์ของตัวเองในการสแกนและชำระเงิน

จะเกิดอะไรขึ้นถ้าการชำระเงินของลูกค้าล้มเหลว?

หากการชำระเงินล้มเหลว คุณจะได้รับ webhook ที่มี status: failed และ failure_code ที่อธิบายเหตุผล (เช่น insufficient_fund, payment_rejected) แสดงข้อความผิดพลาดที่เหมาะสมและอนุญาตให้ลูกค้าลองใหม่

แหล่งข้อมูลที่เกี่ยวข้อง

• ภาพรวม Alipay+ - คู่มือระบบนิเวศ Alipay+ ฉบับเต็ม
• Alipay+ UPM - โหมดลูกค้าแสดง QR
• การชำระเงินด้วย QR - วิธีการชำระเงินด้วย QR อื่นๆ