อาลีเพย์
หัวข้อทั้งหมดในหน้านี้
อาลีเพย์ (Alipay) เป็นอีกหนึ่งช่องทางรับชำระเงินที่ได้รับความนิยมสูงจากร้านค้าที่มีกลุ่มผู้บริโภคชาวจีน หรือต้องการขยายฐานลูกค้าให้เข้าถึงกลุ่มผู้บริโภคชาวจีนมากขึ้น ปัจจุบันมีผู้ใช้งานอาลีเพย์กว่า 450 ล้านบัญชี
โอมิเซะจะช่วยอำนวยความสะดวกให้ร้านค้าสามารถเพิ่มช่องทางรับชำระเงินผ่านระบบอาลีเพย์ได้รวดเร็วขึ้น โดยร้านค้าไม่จำเป็นต้องสมัครกับอาลีเพย์โดยตรง และไม่ต้องมีบัญชีธนาคารของประเทศจีนเพื่อใช้ประกอบการสมัคร
ขั้นตอนการรับชำระเงิน
เมื่อผู้ซื้อเลือกชำระเงินผ่านบริการอาลีเพย์ ระบบจะพาผู้ซื้อไปยังหน้าเว็บไซต์อาลีเพย์โดยอัตโนมัติ เพื่อให้ผู้ซื้อลงชื่อเข้าสู่ระบบและทำการชำระเงิน เมื่อเสร็จสิ้นขั้นตอนแล้ว ระบบก็จะนำผู้ซื้อกลับมายังเว็บไซต์ของร้านค้า (ตามลิงก์ที่ระบุให้เป็น return_uri
) โดยอัตโนมัติ
เมื่อผู้ซื้อถูกส่งไปยังหน้าเว็บไซต์อาลีเพย์ ยอดเงินที่ต้องชำระจะถูกกรอกไว้ให้แล้ว โดยสกุลเงินจะแสดงตามบัญชีที่ร้านค้าจดทะเบียน เช่น ร้านค้าในประเทศไทยจะแสดงเป็นบาท (ในขณะนี้สกุลเงินที่รองรับคือบาทเท่านั้น) ส่วนการดำเนินการตัดเงินของระบบ ยอดจะถูกแปลงเป็นหยวนจีน (CNY) และเมื่อระบบทำรายการเสร็จสิ้น ร้านค้าจะได้รับชำระเงินเข้าบัญชีเป็นสกุลเงินบาท
สร้างรายการรับชำระเงิน
การสร้างรายการรับชำระ (charge) อาลีเพย์มีวิธีคล้ายกันกับการสร้างรายการอินเทอร์เน็ตแบงก์กิ้ง โดยให้ส่งค่าใน field offsite
เป็น alipay
ตัวอย่างการสร้างรายการรับชำระเงินผ่านอาลีเพย์ด้วย cURL
curl https://api.omise.co/charges \
-X POST \
-u skey_test_56rn509djosl176cmm4: \
-d "amount=100000" \
-d "currency=thb" \
-d "offsite=alipay" \
-d "return_uri=http://example.com/orders/1235813/complete"
return_uri
เป็นหน้าเว็บไซต์ที่ผู้ซื้อจะถูกส่งกลับไป เมื่อจบกระบวนการรับชำระเงิน
ตัวอย่าง JSON response
{
"object": "charge",
"id": "chrg_test_57003cpwde7oww4x3o0",
"livemode": false,
"location": "/charges/chrg_test_57003cpwde7oww4x3o0",
"amount": 100000,
"currency": "thb",
"description": null,
"status": "pending",
"capture": true,
"authorized": false,
"reversed": false,
"paid": false,
"transaction": null,
"source_of_fund": "offsite",
"refunded": 0,
"refunds": {
"object": "list",
"from": "1970-01-01T09:00:00+09:00",
"to": "2017-02-14T22:57:38+09:00",
"offset": 0,
"limit": 20,
"total": 0,
"order": null,
"location": "/charges/chrg_test_57003cpwde7oww4x3o0/refunds",
"data": []
},
"return_uri": "http://example.com/orders/1235813/complete",
"offsite": "alipay",
"reference": "ofsp_test_57003craqffu31xi1mu",
"authorize_uri": "https://pay.omise.co/offsites/ofsp_test_57003craqffu31xi1mu/pay",
"failure_code": null,
"failure_message": null,
"card": null,
"customer": null,
"ip": null,
"dispute": null,
"created": "2017-02-14T13:57:38Z"
}
ร้านค้าจะต้องส่งผู้ซื้อไปยัง authorize_uri
เพื่อดำเนินการต่อ
*สำหรับท่านที่ใช้งานในโหมดทดสอบ ให้คัดลอก URL ที่ถูกส่งกลับมาใน authorize_uri
และวางในเบราว์เซอร์เพื่อใช้ทดสอบ
สามารถตรวจสอบสถานะรายการได้ โดยศึกษาวิธีการเรียกข้อมูลดังกล่าวใน Charges API
- หากทั้ง authorized และ paid เป็น true รายการรับชำระเงิน (charge) นั้นสำเร็จ
- หากทั้ง authorized และ paid เป็น false รายการับชำระเงิน (charge) นั้นไม่สำเร็จ (สามารถตรวจสอบ
failure_code
และfailure_message
ได้จาก Charge object) - Authorized และ paid ไม่สามารถมีค่าที่ต่างกันได้
การคืนเงิน (refund)
สามารถทำการคืนเงินให้แก่ลูกค้าของคุณโดยเรียกใช้ Refund API หรือดำเนินการผ่าน dashboard
หมายเหตุ: การคืนเงินสามารถทำได้ภายในระยะเวลา 3 เดือนนับจากวันทำรายการ
Webhooks
ร้านค้าสามารถรับการแจ้งเตือนเมื่อมีรายการรับชำระเงินสำเร็จ โดยใช้ Webhook API ซึ่งจะส่ง webhook ไปยัง URL ที่ได้ตั้งไว้ใน dashboard รายการจะแสดงเป็น charge.complete
หมายเหตุ
- สำหรับร้านค้าที่มีอยู่ในโหมดใช้งานจริง (live account) อยู่แล้ว และมีความประสงค์จะเปิดใช้งานอาลีเพย์ กรุณาส่งอีเมล์ถึงทีมงานของเราที่ support@omise.co