Webhook 테스트
테스트 결제
post
https://api.cryptomus.com/v1/test-webhook/payment
WebHook Data Array에서 서명을 확인하려면 결제 API 키를 사용하십시오.
WebHooks를 올바르게 수신하고 서명을 검증 할 수 있도록이 방법을 사용하여 WebHooks를 테스트하여 결제해야합니다.
데이터베이스에 데이터가 저장되지 않으며 Webhook에서받은 데이터는 서명의 정확성을 보장 하고이 배열의 검색을 테스트하기 위해 테스트 목적으로 배열에 저장됩니다.
기존 송장으로 webhook을 테스트하려면 UUID 또는 주문 ID를 제공하십시오. 이러한 매개 변수가 제공되지 않으면 WebHook은 테스트 송장과 함께 전송됩니다.
요구
쿼리 매개 변수
| 이름 | 매개 변수 유형 | 기본값 | 정의 |
|---|---|---|---|
| url_callback* | stringmin:6max:150url | 결제 상태가있는 webhooks가 전송 될 URL | |
| currency* | string | 송장 통화 코드 | |
| network* | string | 송장 네트워크 코드 | |
| uuid | stringuuid | 임의의 uuid 문자열 | 송장의 uuid |
| order_id | stringmin:1max:32alpha_dash | 임의의 문자열 | 송장의 주문 ID |
| status* | string | paid | 지불 상태사용 가능한 옵션 :• process• check• paid• paid_over• fail• wrong_amount• cancel• system_fail• refund_process• refund_fail• refund_paid |
매개 변수 유형
stringmin:6max:150url정의
결제 상태가있는 webhooks가 전송 될 URL매개 변수 유형
string정의
송장 통화 코드매개 변수 유형
string정의
송장 네트워크 코드매개 변수 유형
stringuuid정의
송장의 uuid매개 변수 유형
stringmin:1max:32alpha_dash정의
송장의 주문 ID매개 변수 유형
string정의
지불 상태사용 가능한 옵션 :- process- check- paid- paid_over- fail- wrong_amount- cancel- system_fail- refund_process- refund_fail- refund_paid
* - 필수 매개 변수
UUID 또는 Order_ID 매개 변수 중 하나를 전달할 수 있습니다. 두 가지를 모두 전달하면 계정은 UUID에 의해 식별됩니다.
요청 예제
curl https://api.cryptomus.com/v1/test-webhook/payment \
-X POST \
-H 'merchant: 860166ce-478c-4087-9813-55cfb6c34580' \
-H 'sign: a466b82fad9415cdbf5f47802b8d376c' \
-H 'Content-Type: application/json' \
-d '{
"uuid": "e1830f1b-50fc-432e-80ec-15b58ccac867",
"currency": "ETH",
"url_callback": "https://your.site/callback",
"network": "eth",
"status": "paid"
}'응답
응답 예
1{
2 "state": 0,
3 "result": []
4}테스트 지불금
post
https://api.cryptomus.com/v1/test-webhook/payout
WebHook Data Array에서 서명을 확인하려면 결제 API 키를 사용하십시오.
요구
쿼리 매개 변수
| 이름 | 매개 변수 유형 | 기본값 | 정의 |
|---|---|---|---|
| url_callback* | stringmin:6max:150url | 결제 상태가있는 webhooks가 전송 될 URL | |
| currency* | string | 지불 통화 코드 | |
| network* | string | 지불금 네트워크 코드 | |
| uuid | stringuuid | 임의의 uuid 문자열 | 지불금의 uuid |
| order_id | stringmin:1max:32alpha_dash | 임의의 문자열 | 지불금의 주문 ID |
| status* | string | paid | 지불 상태사용 가능한 옵션 :• process• check• paid• fail• cancel• system_fail |
매개 변수 유형
stringmin:6max:150url정의
결제 상태가있는 webhooks가 전송 될 URL매개 변수 유형
string정의
지불 통화 코드매개 변수 유형
string정의
지불금 네트워크 코드매개 변수 유형
stringuuid정의
지불금의 uuid매개 변수 유형
stringmin:1max:32alpha_dash정의
지불금의 주문 ID매개 변수 유형
string정의
지불 상태사용 가능한 옵션 :- process- check- paid- fail- cancel- system_fail
* - 필수 매개 변수
UUID 또는 Order_ID 매개 변수 중 하나를 전달할 수 있습니다. 두 가지를 모두 전달하면 계정은 UUID에 의해 식별됩니다.
요청 예제
curl https://api.cryptomus.com/v1/test-webhook/payout \
-X POST -H 'merchant: 860166ce-478c-4087-9813-55cfb6c34580' \
-H 'sign: a466b82fad9415cdbf5f47802b8d376c' \
-H 'Content-Type: application/json' \
-d '{
"uuid": "e1830f1b-50fc-432e-80ec-15b58ccac867",
"currency": "ETH",
"url_callback": "https://your.site/callback",
"network": "eth",
"status": "paid"
}'응답
응답 예
1{
2 "state": 0,
3 "result": []
4}테스트 지갑
post
https://api.cryptomus.com/v1/test-webhook/wallet
WebHook Data Array에서 서명을 확인하려면 결제 API 키를 사용하십시오.
요구
쿼리 매개 변수
| 이름 | 매개 변수 유형 | 기본값 | 정의 |
|---|---|---|---|
| url_callback* | stringmin:6max:150url | 결제 상태가있는 webhooks가 전송 될 URL | |
| currency* | string | 지불 통화 코드 | |
| network* | string | 결제 네트워크 코드 | |
| uuid | stringuuid | 임의의 uuid 문자열 | 비즈니스 지갑의 uuid |
| order_id | stringmin:1max:32alpha_dash | 임의의 문자열 | 송장의 주문 ID |
| status* | string | paid | 지불 상태사용 가능한 옵션 :• process• check• paid• paid_over• fail• wrong_amount• cancel• system_fail• refund_process• refund_fail• refund_paid |
매개 변수 유형
stringmin:6max:150url정의
결제 상태가있는 webhooks가 전송 될 URL매개 변수 유형
string정의
지불 통화 코드매개 변수 유형
string정의
결제 네트워크 코드매개 변수 유형
stringuuid정의
비즈니스 지갑의 uuid매개 변수 유형
stringmin:1max:32alpha_dash정의
송장의 주문 ID매개 변수 유형
string정의
지불 상태사용 가능한 옵션 :- process- check- paid- paid_over- fail- wrong_amount- cancel- system_fail- refund_process- refund_fail- refund_paid
* - 필수 매개 변수
요청 예제
curl https://api.cryptomus.com/v1/test-webhook/wallet \
-X POST -H 'merchant: 860166ce-478c-4087-9813-55cfb6c34580' \
-H 'sign: a466b82fad9415cdbf5f47802b8d376c' \
-H 'Content-Type: application/json' \
-d '{
"uuid": "e1830f1b-50fc-432e-80ec-15b58ccac867",
"currency": "ETH",
"url_callback": "https://your.site/callback",
"network": "eth",
"status": "paid"
}'응답
응답 예
1{
2 "state": 0,
3 "result": []
4}가능한 오류
유효성 검사 오류
암호 : 422
예제 응답 :
uuid 또는 order_id 를 통과하고 송장/정적 지갑/지불금을 찾을 수 없습니다.
1{
2 "state": 1,
3 "message": "Not found payment"
4}
1{
2 "state": 1,
3 "message": "Not found payout"
4}
1{
2 "state": 1,
3 "message": "Not found wallet"
4}필요한 매개 변수를 전달하지 않으면 :
1{
2 "state": 1,
3 "errors": {
4 "currency": ["validation.required"]
5 }
6}제공된 통화 및 네트워크가 암호화되지 않거나 지원되지 않는 경우 :
1{
2 "state": 1,
3 "message": "Payment service not found"
4}
1{
2 "state": 1,
3 "message": "Payout service not found"
4}