Ewallet

Server

สร้างลิงก์เปลี่ยนเส้นทางการชำระเงิน Ewallet และตรวจสอบสถานะธุรกรรม ใช้ตำแหน่งข้อมูลเหล่านี้เมื่อลูกค้าชำระเงินผ่านแอป Ewallet ที่รองรับ และระบบของคุณต้องการการเปลี่ยนเส้นทาง URL พร้อมสถานะการปรับยอด

สร้างลิงค์ชำระเงิน Ewallet API

POST

https://sandbox.onebrick.io

/v2/payments/gs/acceptance/ewallet

publicAccessToken (header)

สร้างลิงก์การชำระเงิน Ewallet หรือเปลี่ยนเส้นทาง URL สำหรับการชำระเงินของลูกค้า ใช้ endpoint นี้เมื่อผู้ชำระเงินควรชำระเงินให้เสร็จสิ้นภายในแอปพลิเคชัน Ewallet ที่รองรับหรือเปลี่ยนเส้นทางประสบการณ์การชำระเงิน เก็บตัวระบุการชำระเงินที่ส่งคืนและเปลี่ยนเส้นทาง URL จากนั้นยืนยันสถานะธุรกรรมสุดท้ายผ่าน callback หรือสถานะ Ewallet endpoint

สร้างลิงค์ชำระเงิน Ewallet API › Request Body

amount

integer · int32 · required

จำนวนเงินที่ลูกค้าต้องการโอน

Default: 10000

referenceId

string · required

ตัวระบุที่ไม่ซ้ำกันสำหรับธุรกรรมการชำระเงินที่สร้างโดยฝั่งไคลเอ็นต์ (ความยาวสูงสุด 25 ตัวอักษร)

Default: Test-Sandbox-01

ewalletCode

string · required

รหัสที่แสดงถึงผู้ให้บริการ Ewallet (เช่น "DANA" สำหรับ DANA Ewallet, "LINKAJA" สำหรับ LinkAja Ewallet)

Default: DANA

returnUrl

string · required

URL ที่ผู้ใช้ปลายทางจะถูกเปลี่ยนเส้นทางไปหลังจากเสร็จสิ้นธุรกรรม

Default: https://staging-app.onebrick.io

สร้างลิงค์ชำระเงิน Ewallet API › Responses

200

status

integer

Default: 0

object

error

POST/v2/payments/gs/acceptance/ewallet

curl https://sandbox.onebrick.io/v2/payments/gs/acceptance/ewallet \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'publicAccessToken: <api-key>' \
  --data '{
  "amount": 10000,
  "referenceId": "Test-Sandbox-01",
  "ewalletCode": "DANA",
  "returnUrl": "https://staging-app.onebrick.io"
}'

Example Request Body

{
  "amount": 10000,
  "referenceId": "Test-Sandbox-01",
  "ewalletCode": "DANA",
  "returnUrl": "https://staging-app.onebrick.io"
}

json

application/json

Example Responses

{
    "status": 200,
    "data": {
        "message": "We have successfully created Ewallet payment",
        "id": "WA_6149a003a0cb4efcab067c342f499f8e",
        "referenceId": "Test-Sandbox-01",
        "amount": "10000",
        "status": "pending",
        "ewalletCode": "DANA",
        "redirectUrl": "https://m.sandbox.dana.id/m/portal/cashier/checkout?bizNo=20240912111212800110166401001777756&timestamp=1726139689936&originSourcePlatform=IPG&mid=216620040016026395535&sign=IheVHgdUym9p11XLDZ0KqT1%2F5uKqqNjG%2B85CpmVL6LFaJwKPKoEzjTxm8bqg0Vl9CF8G1blf2YUxmNlqeNKvMUoaDh5K%2F50sEscp2fjjY3VnJU4rqiug57Lu1JLGVQ9H%2BL9ff3Kohfz4YEJ3v4kT0mJQZke%2F5Io0PytviPmaMUuOCA%2F9AmeSKg2UVEWbsZdYNbRioLChfAFivnY2Zbv70XQ8wBkOgF1KBnRqh6ONmzCcrSu9EmgoCldPEegZnpGsa0%2BR28W%2FwZ7ZKpi76bLV62Soeg4uQtRoKOcAA6iVhHZ8rmGSFjHGgnpr6C6fgberCfy3cBRlOoLhCE67e1L2tg%3D%3D&forceToH5=false",
        "createdAt": "2024-09-12T18:14:49.000+07:00",
        "expiredAt": "2024-09-12T19:15:49.817+07:00"
    },
    "metaData": {
        "source": "API",
        "entity": "Payment"
    },
    "error": null
}

json

application/json

สถานะ Ewallet การชำระเงิน API

GET

https://sandbox.onebrick.io

/v2/payments/gs/acceptance/ewallet/{id}

publicAccessToken (header)

รับสถานะล่าสุดของธุรกรรมการชำระเงิน Ewallet โดย Brick reference ID ใช้ endpoint นี้เมื่อ callbacks เกิดความล่าช้า ฝ่ายสนับสนุนลูกค้าต้องการการยืนยัน หรือกระบวนการกระทบยอดของคุณจำเป็นต้องแก้ไขสถานะลิงก์การชำระเงิน ควรใช้การตอบกลับเพื่ออัปเดตคำสั่งซื้อภายใน ใบแจ้งหนี้ หรือบันทึกเงินทุนในกระเป๋าเงิน

สถานะ Ewallet การชำระเงิน API › path Parameters

id

string · required

ตัวระบุเฉพาะสำหรับธุรกรรมการชำระเงิน ที่สร้างโดย Brick EX: WA_xxx

สถานะ Ewallet การชำระเงิน API › Responses

200

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for การตอบสนองความสำเร็จ - รอดำเนินการ:

status

integer

Default: 0

object

error

GET/v2/payments/gs/acceptance/ewallet/{id}

curl https://sandbox.onebrick.io/v2/payments/gs/acceptance/ewallet/:id \
  --header 'publicAccessToken: <api-key>'

Example Responses

{
    "status": 200,
    "data": {
        "message": "We have successfully get status Ewallet",
        "id": "WA_6149a003a0cb4efcab067c342f499f8e",
        "referenceId": "Test-Sandbox-01",
        "amount": "10000",
        "status": "pending",
        "ewalletCode": "DANA",
        "redirectUrl": "https://m.sandbox.dana.id/m/portal/cashier/checkout?bizNo=20240912111212800110166401001777756&timestamp=1726139689936&originSourcePlatform=IPG&mid=216620040016026395535&sign=IheVHgdUym9p11XLDZ0KqT1%2F5uKqqNjG%2B85CpmVL6LFaJwKPKoEzjTxm8bqg0Vl9CF8G1blf2YUxmNlqeNKvMUoaDh5K%2F50sEscp2fjjY3VnJU4rqiug57Lu1JLGVQ9H%2BL9ff3Kohfz4YEJ3v4kT0mJQZke%2F5Io0PytviPmaMUuOCA%2F9AmeSKg2UVEWbsZdYNbRioLChfAFivnY2Zbv70XQ8wBkOgF1KBnRqh6ONmzCcrSu9EmgoCldPEegZnpGsa0%2BR28W%2FwZ7ZKpi76bLV62Soeg4uQtRoKOcAA6iVhHZ8rmGSFjHGgnpr6C6fgberCfy3cBRlOoLhCE67e1L2tg%3D%3D&forceToH5=false",
        "expiredAt": "2024-09-12T19:15:49.817+07:00"
    },
    "metaData": {
        "source": "API",
        "entity": "Payment"
    },
    "error": null
}

json

application/json

หน้า Checkout QR Code แบบไดนามิก

สร้างลิงค์ชำระเงิน Ewallet API

POST

https://sandbox.onebrick.io

/v2/payments/gs/acceptance/ewallet

publicAccessToken (header)

สร้างลิงค์ชำระเงิน Ewallet API › Request Body

amount

integer · int32 · required

จำนวนเงินที่ลูกค้าต้องการโอน

Default: 10000

referenceId

string · required

Default: Test-Sandbox-01

ewalletCode

string · required

รหัสที่แสดงถึงผู้ให้บริการ Ewallet (เช่น "DANA" สำหรับ DANA Ewallet, "LINKAJA" สำหรับ LinkAja Ewallet)

Default: DANA

returnUrl

string · required

URL ที่ผู้ใช้ปลายทางจะถูกเปลี่ยนเส้นทางไปหลังจากเสร็จสิ้นธุรกรรม

Default: https://staging-app.onebrick.io

สร้างลิงค์ชำระเงิน Ewallet API › Responses

200

status

integer

Default: 0

object

error

สถานะ Ewallet การชำระเงิน API

GET

https://sandbox.onebrick.io

/v2/payments/gs/acceptance/ewallet/{id}

publicAccessToken (header)

สถานะ Ewallet การชำระเงิน API › path Parameters

id

string · required

ตัวระบุเฉพาะสำหรับธุรกรรมการชำระเงิน ที่สร้างโดย Brick EX: WA_xxx

สถานะ Ewallet การชำระเงิน API › Responses

200

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for การตอบสนองความสำเร็จ - รอดำเนินการ:

status

integer

Default: 0

object

error