환불하다
post https://api.cryptomus.com/v1/payment/refund 복사
요구
쿼리 매개 변수
| 이름 | 매개 변수 유형 | 정의 |
|---|---|---|
| address* | string | 환불 해야하는 주소 |
| is_subtract* | boolean | 가맹점 잔액에서 커미션을 받을지 또는 환불 금액에서 True - 상인 잔고에서 커미션을 취하십시오. false - 커미션 금액만큼 환불 가능한 금액 감소 |
| uuid* | uuidrequired_without: order_id | 송장 uuid |
| order_id* | stringmin:1max:128alpha_dashrequired_without: uuid | 송장 주문 ID |
매개 변수 유형
string정의
환불 해야하는 주소매개 변수 유형
boolean정의
가맹점 잔액에서 커미션을 받을지 또는 환불 금액에서 True - 상인 잔고에서 커미션을 취하십시오. false - 커미션 금액만큼 환불 가능한 금액 감소매개 변수 유형
uuidrequired_without: order_id정의
송장 uuid매개 변수 유형
stringmin:1max:128alpha_dashrequired_without: uuid정의
송장 주문 ID
* - 필수 매개 변수
송장은 다음으로 식별됩니다 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}