คืนเงิน

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}
สำเนา