คืนเงิน
post
https://api.cryptomus.com/v1/payment/refund
ขอ
พารามิเตอร์การค้นหา
ชื่อ | ประเภทพารามิเตอร์ | คำนิยาม |
---|---|---|
address* | string | ที่อยู่ที่ต้องการขอคืนเงิน |
is_subtract* | boolean | ไม่ว่าจะรับค่าคอมมิชชั่นจากยอดคงเหลือของผู้ค้าหรือจากจำนวนเงินคืนจริง - รับค่าคอมมิชชั่นจากยอดคงเหลือของผู้ค้าเท็จ - ลดจำนวนเงินที่คืนได้ด้วยค่าคอมมิชชั่น |
uuid* | uuidrequired_without: order_id | ใบแจ้งหนี้ uuid |
order_id* | stringmin:1max:128alpha_dashrequired_without: uuid | รหัสคำสั่งซื้อใบแจ้งหนี้ |
ประเภทพารามิเตอร์
stringคำนิยาม
ที่อยู่ที่ต้องการขอคืนเงินประเภทพารามิเตอร์
booleanคำนิยาม
ไม่ว่าจะรับค่าคอมมิชชั่นจากยอดคงเหลือของผู้ค้าหรือจากจำนวนเงินคืนจริง - รับค่าคอมมิชชั่นจากยอดคงเหลือของผู้ค้าเท็จ - ลดจำนวนเงินที่คืนได้ด้วยค่าคอมมิชชั่นประเภทพารามิเตอร์
uuidrequired_without: order_idคำนิยาม
ใบแจ้งหนี้ uuidประเภทพารามิเตอร์
stringmin:1max:128alpha_dashrequired_without: uuidคำนิยาม
รหัสคำสั่งซื้อใบแจ้งหนี้
* - พารามิเตอร์บังคับ
ใบแจ้งหนี้จะถูกระบุโดย order_id หรือ uuidหากผ่านทั้งสองบัญชีจะถูกระบุด้วย uuid
ขอตัวอย่าง
curl https://api.cryptomus.com/v1/payment/refund \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{
"uuid": "8b03432e-385b-4670-8d06-064591096795",
"address": "TDD97yguPESTpcrJMqU6h2ozZbibv4Vaqm",
"is_subtract": "true"
}'
สำเนาการตอบสนอง
ตัวอย่างการตอบกลับ
1{
2 "state": 0,
3 "result": []
4}
สำเนาข้อผิดพลาดที่อาจเกิดขึ้น
ข้อผิดพลาดในการตรวจสอบ
รหัส : 422
ตัวอย่างคำตอบ:
หากใบแจ้งหนี้ที่มี uuid หรือ order_id ที่คุณให้มาไม่มีอยู่:
1{
2 "state": 1,
3 "message": "Payment was not found"
4}
สำเนาหากคุณไม่ส่ง uuid และ order_id คุณจะได้รับข้อความนี้ ซึ่งหมายความว่าต้องมีพารามิเตอร์อย่างน้อยหนึ่งตัว
1{
2 "state": 1,
3 "errors": {
4 "uuid": ["validation.required_without"],
5 "order_id": ["validation.required_without"]
6 }
7}
สำเนาหากร้านค้าของคุณบล็อกการจ่ายเงิน คุณจะได้รับข้อความแสดงข้อผิดพลาดนี้ ซึ่งจะเกิดขึ้นเมื่อคุณเปลี่ยนรหัสผ่านและการจ่ายเงินถูกบล็อกเป็นเวลา 24 ชั่วโมง
1{
2 "state": 1,
3 "message": "You are forbidden"
4}
5
สำเนาหากไม่มีกระเป๋าสตางค์ของผู้ค้าที่เชื่อมต่อกับใบแจ้งหนี้:
1{
2 "state": 1,
3 "message": "Undefined merchant wallet"
4}
สำเนาหากใบแจ้งหนี้ไม่เสร็จสิ้นหรือไม่ได้รับการชำระเงิน
1{
2 "state": 1,
3 "message": "Refunds are made only for completed payments"
4}
สำเนาหากจำนวนเงินที่ต้องการคืนเกินกว่าจำนวนเงินที่ชำระตามใบแจ้งหนี้:
1{
2 "state": 1,
3 "message": "The refund amount should not be more than the amount paid"
4}
สำเนาหากเกิดงานทางเทคนิคและไม่สามารถชำระเงินได้ชั่วคราว คุณอาจได้รับข้อความแสดงข้อผิดพลาดดังต่อไปนี้:
1{
2 "state": 1,
3 "message": "Server error"
4}
สำเนา