Alipay CN
หัวข้อทั้งหมดในหน้านี้
รับชำระเงินออนไลน์จากผู้ใช้อาลีเพย์ (Alipay) ผ่านทางเว็บไซต์ของคุณ โดยเปิดใช้ช่องทางรับชำระเงิน AlipayCN
ช่องทางการชำระเงินดังกล่าวจะช่วยให้ธุรกิจร้านค้าของคุณสามารถเข้าถึงหนึ่งในวิธีการชำระเงินออนไลน์ที่ได้รับความนิยมมากที่สุดในจีน โดยทางร้านค้าไม่จำเป็นต้องสมัครกับอาลีเพย์โดยตรง และไม่ต้องมีบัญชีธนาคารของจีนเพื่อใช้ประกอบการสมัคร
ในคู่มือแนะนำการใช้งานนี้จะอธิบายขั้นตอนการชำระเงิน และรายละเอียดวิธีการติดตั้งเพื่อใช้งาน
การเปิดรับชำระเงิน
- ประเทศที่รองรับ: ประเทศไทย, สิงคโปร์
- API เวอร์ชันล่าสุดที่รองรับ:
2017-11-02
ร้านค้าที่ต้องการเปิดใช้ระบบ Alipay CN กรุณาส่งอีเมลมาที่ support@opn.ooo
Payment flow
Alipay CN รองรับการชำระเงินผ่านแอปพลิเคชันมือถือและเว็บไซต์ โดยขั้นตอนการชำระเงินผ่าน Alipay CN จะเป็นแบบ app_redirect ซึ่งหมายความว่า ระบบจะส่งผู้ซื้อไปยังหน้าชำระเงินที่ปลอดภัยของ Alipay CN เพื่อให้ผู้ซื้ออนุมัติและยืนยันการทำรายการ สำหรับผู้ซื้อที่ใช้งานโทรศัพท์มือถือสามารถชำระเงินผ่านแอปพลิเคชัน Alipay CN ได้เลย ส่วนผู้ซื้อที่ต้องการชำระเงินผ่านทางเว็บไซต์จะต้องสแกนคิวอาร์โค้ดผ่านแอปพลิเคชัน Alipay CN บนมือถือ หรือล็อกอินเข้าบัญชี Alipay CN เพื่อยืนยันการชำระเงิน โดยตัวอย่างภาพหน้าจอนี้จะแสดงขั้นตอนการชำระเงินที่แบ่งออกเป็น 2 รูปแบบ ได้แก่ การสแกนคิวอาร์บนคอมพิวเตอร์ และการสแกนคิวอาร์โค้ดบนมือถือ
Using a mobile
❶ เมื่อผู้ซื้อเลือกวอลเล็ตที่จะใช้ชำระเงิน ❷ ระบบจะส่งผู้ซื้อไปที่แอปพลิเคชันของวอลเล็ต เพื่อยืนยันการทำรายการ ❸ ผู้ซื้อจะได้เห็นรายละเอียดข้อมูลการชำระเงินทั้งหมด ❹ ผู้ซื้อสามารถเลือก กลับไปยังร้านค้า
เพื่อยืนยันการทำรายการที่หน้าชำระเงินของร้านค้าได้
Using a desktop browser
❶ เมื่อผู้ซื้อเลือกวอลเล็ตที่จะใช้ชำระเงิน ❷ จะมีคิวอาร์โค้ดปรากฎขึ้นมา ❸ ผู้ซื้อเปิดใช้ที่สแกนคิวอาร์ในแอปพลิเคชันวอลเล็ต ❹ ผู้ซื้อสแกนคิวอาร์โค้ด ❺ ระบบจะสรุปข้อมูลการชำระเงินให้ผู้ซื้อ ก่อนยืนยันการทำรายการ ❻ จากนั้นระบบจะแสดงสลิปยืนยันการทำรายการ ซึ่งทางผู้ซื้อสามารถเลือก กลับไปยังร้านค้า
เพื่อยืนยันการทำรายการที่หน้าชำระเงินของร้านค้าได้ ➐ เมื่อการชำระเงินสำเร็จแล้ว ทางร้านค้าจะได้รับการแจ้งเตือนผ่าน webhook เพื่อยืนยันการทำรายการกับผู้ซื้อ
Implementation
Note: alipay
will be deprecated in favor of alipay_cn
ในการสร้างรายการรับชำระเงินผ่านAlipay CN ให้ร้านค้าส่งคำสั่ง API ดังนี้
- สร้าง payment source (
type
:alipay_cn
) โดยใช้ Omise.js, omise-ios หรือ omise-android - สร้าง charge โดยใช้ source จากขั้นตอนแรก
- เมื่อผู้ซื้อทำรายการสำเร็จและร้านค้าได้รับ webhook event หรือ
charge.complete
แล้ว เราแนะนำให้ตรวจสอบสถานะรายการด้วยตนเองอีกครั้งเพื่อความแม่นยำ
การสร้าง source เพื่อรับชำระเงินผ่านAlipay CN จะเกิดขึ้นในฝั่งของผู้ซื้อ (client-side) เช่นบนเว็บไซต์หรือโทรศัพท์มือถือของผู้ซื้อ ร้านค้าจะต้องใช้ public key
ส่วนการสร้างรายการ (charge) เพื่อรับชำระเงินผ่านAlipay CN จะเกิดขึ้นในฝั่งของร้านค้า (server-side) ร้านค้าจะต้องใช้ secret key
หมายเหตุ: หากมีความจำต้องสร้างทั้งรายการและ source ในฝั่งร้านค้า (server-side) สามารถทำพร้อมกันได้เลยโดยการส่งคำสั่ง API เพียงครั้งเดียว และใช้งาน secret key
การสร้าง source
เมื่อผู้ซื้อเลือกชำระเงินผ่านช่องทางนี้ ให้ร้านค้าสร้าง source ผ่าน source API โดยกำหนด amount
, currency
, platform_type
, และ type
Parameter | Type | Description |
---|---|---|
amount |
integer | (required) See Limits |
currency |
string | (required) Currency for source as three-letter ISO 4217 code (SGD for Singapore , THB for Thailand) |
platform_type |
string | (optional) Platform the payer is making payment on, iOS ANDROID or WEB |
type |
string | (required) alipay_cn |
ตัวอย่างด้านล่างนี้เป็นการสร้าง source สำหรับรายการ Alipay CN จำนวน S$1500
ให้แทนค่าของ omise_public_key
และ $OMISE_PUBLIC_KEY
ด้วย test public key ของร้านค้าซึ่งสามารถคัดลอกได้จาก แดชบอร์ด
หากใช้ Omise.js parameter
type
เป็นตัวแปรที่จำเป็นของฟังก์ชันcreateSource
Omise.setPublicKey(omise_public_key);
Omise.createSource('alipay_cn', {
"amount": 150000,
"currency": "SGD",
"platform_type": "WEB"
}, function(statusCode, response) {
console.log(response)
});
หากร้านค้าต้องการทดสอบให้สร้าง request โดยใช้ curl
curl https://api.omise.co/sources \
-u $OMISE_PUBLIC_KEY: \
-d "amount=150000" \
-d "currency=SGD" \
-d "type=alipay_cn" \
-d "platform_type=WEB"
{
"object": "source",
"id": "src_test_611q9subkcwnw4c1ruw",
"livemode": false,
"location": "/sources/src_test_611q9subkcwnw4c1ruw",
"amount": 150000,
"barcode": null,
"bank": null,
"created_at": "2024-09-11T05:06:29Z",
"currency": "SGD",
"email": null,
"flow": "app_redirect",
"installment_term": null,
"ip": "35.198.236.178",
"absorption_type": null,
"name": null,
"mobile_number": null,
"phone_number": null,
"platform_type": "WEB",
"scannable_code": null,
"billing": null,
"shipping": null,
"items": [],
"references": null,
"provider_references": null,
"store_id": null,
"store_name": null,
"terminal_id": null,
"type": "alipay_cn",
"zero_interest_installments": null,
"charge_status": "unknown",
"receipt_amount": null,
"discounts": [],
"promotion_code": null
}
ตัวแปรของ id
คือ source identifier (เริ่มต้นด้วย src
)
การสร้างรายการรับชำระเงิน
สร้างรายการรับชำระเงินโดยระบุ parameter return_uri
, source
, amount
และ currency
return_uri
จะเป็นตำแหน่งบนเว็บไซต์ของร้านค้าที่ผู้ซื้อจะถูกส่งไปเมื่อยืนยันรายการสำเร็จreturn_uri ต้องเป็น HTTPS ฟอร์แมต.
source
จะเป็นตัวกำหนด source identifieramount
และcurrency
จะต้องมีค่าตรงกับamount
และcurrency
ของ source
ตัวอย่างด้านล่างนี้แสดงการสร้างรายการรับชำระเงินผ่าน ขึ้นใหม่โดยใช้ curl
ในการสร้างรายการให้ร้านค้าแทน $OMISE_SECRET_KEY
ด้วย test secret key ของร้านค้าซึ่งสามารถคัดลอกได้จากแดชบอร์ด และแทน $SOURCE_ID
ด้วย id
ของ source
curl https://api.omise.co/charges \
-u $OMISE_SECRET_KEY: \
-d "amount=150000" \
-d "currency=SGD" \
-d "return_uri=https://example.com/orders/345678/complete" \
-d "source=$SOURCE_ID"
{
"object": "charge",
"id": "chrg_test_611q9sxboitkv7ry453",
"location": "/charges/chrg_test_611q9sxboitkv7ry453",
"amount": 150000,
"acquirer_reference_number": null,
"net": 145650,
"fee": 4350,
"fee_vat": 0,
"interest": 0,
"interest_vat": 0,
"funding_amount": 150000,
"refunded_amount": 0,
"transaction_fees": {
"fee_flat": "0.0",
"fee_rate": "2.9",
"vat_rate": "0.0"
},
"platform_fee": {
"fixed": null,
"amount": null,
"percentage": null
},
"currency": "SGD",
"funding_currency": "SGD",
"ip": null,
"refunds": {
"object": "list",
"data": [],
"limit": 20,
"offset": 0,
"total": 0,
"location": "/charges/chrg_test_611q9sxboitkv7ry453/refunds",
"order": "chronological",
"from": "1970-01-01T00:00:00Z",
"to": "2024-09-11T05:06:29Z"
},
"link": null,
"description": null,
"metadata": {},
"card": null,
"source": {
"object": "source",
"id": "src_test_611q9sl2z1mxyugef66",
"livemode": false,
"location": "/sources/src_test_611q9sl2z1mxyugef66",
"amount": 150000,
"barcode": null,
"bank": null,
"created_at": "2024-09-11T05:06:27Z",
"currency": "SGD",
"email": null,
"flow": "app_redirect",
"installment_term": null,
"ip": "35.198.236.178",
"absorption_type": null,
"name": null,
"mobile_number": null,
"phone_number": null,
"platform_type": "WEB",
"scannable_code": null,
"billing": null,
"shipping": null,
"items": [],
"references": null,
"provider_references": null,
"store_id": null,
"store_name": null,
"terminal_id": null,
"type": "alipay_cn",
"zero_interest_installments": null,
"charge_status": "pending",
"receipt_amount": null,
"discounts": [],
"promotion_code": null
},
"schedule": null,
"linked_account": null,
"customer": null,
"dispute": null,
"transaction": null,
"failure_code": null,
"failure_message": null,
"status": "pending",
"authorize_uri": "https://pay.omise.co/payments/pay2_test_611q9sxdm1xc48z8t6m/authorize?acs=false",
"return_uri": "https://example.com/orders/345678/complete",
"created_at": "2024-09-11T05:06:29Z",
"paid_at": null,
"authorized_at": null,
"expires_at": "2024-09-18T05:06:29Z",
"expired_at": null,
"reversed_at": null,
"zero_interest_installments": false,
"branch": null,
"terminal": null,
"device": null,
"authorized": false,
"capturable": false,
"capture": true,
"disputable": false,
"livemode": false,
"refundable": false,
"partially_refundable": false,
"reversed": false,
"reversible": false,
"voided": false,
"paid": false,
"expired": false,
"can_perform_void": false,
"approval_code": null
}
การสร้าง source และรายการรับชำระเงิน
ร้านค้าสามารถสร้างทั้ง source และ รายการรับชำระเงิน (charge) ผ่านการเรียกใช้ API เพียงครั้งเดียว
curl https://api.omise.co/charges \
-u $OMISE_SECRET_KEY: \
-d "amount=150000" \
-d "currency=SGD" \
-d "return_uri=https://example.com/orders/345678/complete" \
-d "source[type]=alipay_cn" \
-d "source[platform_type]=WEB"
สร้างรายการสำเร็จ
เมื่อร้านค้าสร้างรายการรับชำระเงินขึ้นมาแล้ว จะพบว่าสถานะของรายการแสดงเป็น pending
หรือ status==pending
โดยสถานะของรายการรับชำระเงินสามารถเป็นได้ทั้ง successful
, failed
และ expired
ในส่วนต่อไปเราจะอธิบายวิธีอนุมัติรายการ, การรับ event แจ้งเตือนเมื่อรายการเสร็จสิ้นผ่าน webhook และการตรวจสอบสถานะรายการ
ภาพด้านล่างนี้แสดงให้เห็นถึงขั้นตอนทั้งหมดในการรับชำระเงินแต่ละรายการ
การอนุมัติรายการรับชำระเงิน
ระบบจะส่งผู้ซื้อไปยังตำแหน่งที่ระบุไว้ใน authorize_uri
เพื่อให้ผู้ซื้อสามารถดำเนินการอนุมัติรายการรับชำระเงินได้
ร้านค้าสามารถจำลองขั้นตอนการอนุมัติรายการในโหมดทดสอบ โดยเข้าไปที่ authorize_uri
เพื่อปรับสถานะรายการเป็น “สำเร็จ” หรือ “ไม่สำเร็จ” ได้ด้วยตนเอง หลังจากผู้ซื้อทำการอนุมัติรายการเสร็จสิ้น ผู้ซื้อจะถูกส่งไปยังหน้าที่ร้านค้าระบุเป็น return_uri
เอาไว้
การรับ event แจ้งเตือนรายการสำเร็จ
ร้านค้าสามารถรับการแจ้งเตือนเมื่อมีการทำรายการเสร็จสิ้นโดยใช้งาน webhook events
ในการติดตั้งให้ร้านค้ากำหนดตำแหน่งบนเซิร์ฟเวอร์เพื่อรับ webhook events และเพิ่มตำแหน่งเดียวกันนี้เป็น webhook endpoint บนแดชบอร์ด
เมื่อมีรายการเสร็จสิ้น ระบบจะส่ง POST request ไปยัง endpoint นี้ พร้อมทั้งแนบสถานะการตอบกลับของรายการนั้นๆ ไปด้วย
ตัวแปรหลักหรือ key
สำหรับ event object ประกอบไปด้วย charge.complete
และตัวแปร data
ที่มี charge object
อ่านเพิ่มเติมได้ที่ Events API
การตรวจสอบสถานะรายการ
เมื่อได้รับ event ของรายการที่เสร็จสิ้นแล้ว ร้านค้าสามารถตรวจสอบสถานะรายการหรือ status
โดยใช้ Charge API
หากค่าของ charge.status
เป็น successful
หมายถึงว่ารายการรับชำระเงินสำเร็จ หากค่าของ charge.status
เป็น failed
รายการรับชำระเงินนั้นไม่สำเร็จ ร้านค้าสามารถตรวจสอบ failure_code
และ failure_message
ได้ใน charge object เพื่ออ่านคำอธิบายเพิ่มเติม
สาเหตุขัดข้องที่อาจเกิดขึ้นได้มีดังนี้
รหัสข้อขัดข้อง | รายละเอียด |
---|---|
payment_expired |
รายการชำระเงินหมดอายุ |
payment_rejected |
รายการถูกปฏิเสธโดยธนาคารผู้ออกบัตร |
failed_processing |
ระบบทำรายการไม่สำเร็จ |
invalid_account |
ไม่พบบัญชีที่สามารถชำระเงินผ่านช่องทางที่เลือก |
insufficient_fund |
วงเงินคงเหลือไม่เพียงพอหรือวงเงินเต็ม |
See the Refunds API documentation for information on how to refund a payment charge.
Alipay payment charges can be voided within the next 00:15(GMT+8) after the charge was created.
ข้อจำกัด
Singapore
- จำนวนรับชำระขั้นต่ำ:
100
(SGD 1.00) - จำนวนรับชำระสูงสุด:
2000000
(SGD 20,000.00)
Thailand
- จำนวนรับชำระขั้นต่ำ:
2000
(THB 20.00) - จำนวนรับชำระสูงสุด:
15000000
(THB 150,000.00)