โมเดลข้อมูล - ช่องทางการชำระเงิน

ภาพรวมช่องทางการชำระเงิน

โมเดลข้อมูลช่องทางการชำระเงินจะกำหนดโครงสร้างสำหรับข้อมูลวิธีการชำระเงินและการประมวลผล โมเดลนี้จะรวมข้อมูลรายละเอียดวิธีการชำระเงิน รายละเอียดการประมวลผล และพารามิเตอร์เฉพาะช่องทาง

โครงสร้างโมเดลข้อมูล

พารามิเตอร์	ประเภท	คำอธิบาย
paymentMethod	String	ตัวระบุวิธีการชำระเงิน รูปแบบ: รหัสวิธีการชำระเงินที่กำหนดไว้ล่วงหน้า ตัวอย่าง: BRI, UPI, QRPAY, PIX, SPEI ใช้เพื่อระบุช่องทางการชำระเงินเฉพาะสำหรับการประมวลผลธุรกรรม
vaNumber	String	หมายเลขบัญชีเสมือนหรือบัญชีธนาคาร รูปแบบ: สตริงตัวอักษรและตัวเลข การใช้งาน: หมายเลข VA อินโดนีเซีย บัญชีธนาคารไทย บัญชี SPEI เม็กซิโก จำเป็นสำหรับวิธีการชำระเงินแบบโอนเงินธนาคาร
qrString	String	ข้อมูล QR code หรือ URL รูปภาพ รูปแบบ: สตริงหรือ URL รูปภาพ HTTP การใช้งาน: QRIS อินโดนีเซีย QRPAY ไทย PIX บราซิล มีข้อมูล QR code สำหรับการประมวลผลการชำระเงินมือถือ
paymentUrl	String	URL หลักสำหรับการประมวลผลการชำระเงิน รูปแบบ: URL HTTP/HTTPS ที่ถูกต้อง การใช้งาน: หน้าชำระเงิน Smilepayz สำหรับการเสร็จสิ้นการชำระเงิน จำเป็นสำหรับวิธีการชำระเงินทั้งหมด
receiverBankName	String	ชื่อธนาคารผู้รับสำหรับการโอนเงินธนาคาร รูปแบบ: สตริงที่เข้ารหัส UTF-8 การใช้งาน: วิธีการ BANK ไทย SPEI เม็กซิโก ระบุธนาคารผู้รับสำหรับธุรกรรมการโอน
additionalInfo	Object	ข้อมูลเพิ่มเติมสำหรับการประมวลผลการชำระเงิน รูปแบบ: วัตถุ JSON การใช้งาน: URL การชำระเงินแบบขยาย พารามิเตอร์การประมวลผล มีข้อมูลเสริมสำหรับวิธีการชำระเงินเฉพาะ

ตัวอย่างการใช้งานตามภูมิภาค

วิธีการชำระเงินอินโดนีเซีย

{
    "additionalInfo": {
        "paymentUrl": "https://link.dana.id/pay?bizNo=xxxxxxxxxL5dm6QkXs3kDg5HFBtgOtgHmPWpLD9IU2qoxkqQhGJQfCYcn4tA8930VR%2BggxOHPDhZg%3D%3D&forceToH5=false"
    },
    "paymentMethod": "W_DANA",
    "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=101200192501021315010115"
}

{
    "additionalInfo": {},
    "paymentMethod": "QRIS",
    "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=101200112410241325417215",
    "qrString": "https://gateway.smilepayz.com/image/MER202110293394047135422905011630451D5.img"
}

{
    "additionalInfo": {},
    "paymentMethod": "QRIS",
    "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=101200112410241325417215",
    "qrString": "0912121.2232323293.2323232.33xxxxxxxxxxxxxxxxxx3232wewess.w2323.QRIS.sdfdN.nubo.bsdfdc833434343"
}

{
    "additionalInfo": {},
    "paymentMethod": "BRI",
    "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=101200112501021320331776",
    "vaNumber": "1419001332911089"
}

วิธีการชำระเงินอินเดีย

{
    "additionalInfo": {
        "paymentUrl": "upi://xxxxx612963233324SPOphhnctVDAIN5zq9s1z7cgoHpJkjnMXjGoMpMm0AD9IU2qoxkqQhGJQfCYcn4tA8930VR%2BggxOHPDhZg%3D%3D&forceToH5=false"
    },
    "paymentMethod": "UPI",
    "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=101200192501021315010115"
}

{
    "additionalInfo": {
        "paymentUrl": "https://xxxxx612963233324SPOphhnctVDAIN5zq9s1z7cgoHpJkjnMXjGoMpMm0AD9IU2qoxkqQhGJQfCYcn4tA8930VR%2BggxOHPDhZg%3D%3D&forceToH5=false"
    },
    "paymentMethod": "UPI",
    "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=101200192501021315010115"
}

วิธีการชำระเงินไทย

{
    "additionalInfo": {},
    "paymentMethod": "QRPAY",
    "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=111200572411191251468673",
    "qrString": "00020101021229370016A0000006770101110113006680870163353037645406299.985802TH63048436"
}

{
    "additionalInfo": {},
    "paymentMethod": "BANK",
    "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=1112001125042408363186433",
    "receiverBankName": "KBANK",
    "vaNumber": "2053617290"
}

วิธีการชำระเงินบราซิล

{
    "additionalInfo": {},
    "paymentMethod": "PIX",
    "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=131200112412130836186234",
    "qrString": "00020101021226800014br.gov.bcb.pix2558pix.delbank.com.br/v2/cob/vcharge1f6aed0623644c24bbdc174ce5204000053039865802BR5907DELBANK6007ARACAJU62070503***6304BC39"
}

วิธีการชำระเงินเม็กซิโก

{
    "additionalInfo": {},
    "paymentMethod": "SPEI",
    "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=1412075825061113364201615",
    "receiverBankName": "STP",
    "vaNumber": "6461805637046123212"
}

วิธีการชำระเงินเปรู

{
    "additionalInfo": {
        "paymentUrl": "https://checkout.pe.1pago.net/checkout/checkout-s.html?TokenID=e064c70d-3f1b-48f1-a628-2448f51bc54f&CountryID=PER&ChannelID=ONLINE"
    },
    "paymentMethod": "CASHIER_PE",
    "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=1512024025061111131298291"
}

วิธีการชำระเงินโคลอมเบีย

{
    "additionalInfo": {
        "paymentUrl": "https://checkout.co.1pago.net/checkout/checkout-s.html?TokenID=e064c70d-3f1b-48f1-a628-2448f51bc54f&CountryID=COL&ChannelID=ONLINE"
    },
    "paymentMethod": "CASHIER_CO",
    "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=1512024025061111131298291"
}

วิธีการชำระเงินชิลี

{
    "additionalInfo": {
        "paymentUrl": "https://checkout.cl.1pago.net/checkout/checkout-s.html?TokenID=e064c70d-3f1b-48f1-a628-2448f51bc54f&CountryID=CHL&ChannelID=ONLINE"
    },
    "paymentMethod": "CASHIER_CL",
    "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=1512024025061111131298291"
}

แนวทางการใช้งาน

การเลือกวิธีการชำระเงิน

• กระเป๋าเงินดิจิทัล: ใช้วิธีการชำระเงินเฉพาะ e-wallet พร้อม URL การชำระเงินเพิ่มเติม
• การชำระเงิน QR: รวมข้อมูลสตริง QR สำหรับการประมวลผลการชำระเงินมือถือ
• การโอนเงินธนาคาร: ให้หมายเลขบัญชีเสมือนและข้อมูลธนาคารผู้รับ
• การชำระเงินสด: ใช้วิธีการชำระเงินแคชเชียร์พร้อม URL ชำระเงินภายนอก

การพิจารณาด้านความปลอดภัย

• การตรวจสอบ URL: ตรวจสอบให้แน่ใจว่า URL การชำระเงินทั้งหมดใช้โปรโตคอล HTTPS
• การเข้ารหัสข้อมูล: ข้อมูลการชำระเงินที่ละเอียดอ่อนควรถูกเข้ารหัสในการส่ง
• การจัดการโทเค็น: การจัดการโทเค็นการชำระเงินและข้อมูลเซสชันอย่างปลอดภัย
• การบันทึกการตรวจสอบ: รักษาบันทึกที่ครอบคลุมสำหรับกิจกรรมการประมวลผลการชำระเงิน