تست webhook
پرداخت تست
برای اعتبارسنجی امضا از آرایه داده Webhook ، از کلید API پرداخت استفاده کنید.
برای اطمینان از دریافت صحیح webhooks و امکان تأیید امضا، باید از این روش برای آزمایش webhooks برای پرداخت استفاده کنید.
لطفاً توجه داشته باشید که هیچ داده‌ای در پایگاه داده ذخیره نمی‌شود و هر داده‌ای که در webhook دریافت می‌شود تنها برای اهداف آزمایشی در یک آرایه ذخیره می‌شود تا صحت امضاء را بررسی کرده و این آرایه را از ما بازیابی آزمایش کند.
برای تست یک webhook با فاکتور موجود، لطفاً uuid یا شناسه سفارش آن را ارائه دهید. اگر این پارامترها ارائه نشوند، webhook با فاکتور آزمایشی ارسال خواهد شد.
درخواست
پارامترهای پرس و جو
| نام | نوع پارامتری | مقدار پیش فرض | تعریف |
|---|---|---|---|
| url_callback* | stringmin:6max:150url | - | URL که webhooks با وضعیت پرداخت به آن ارسال خواهد شد |
| currency* | string | - | فاکتور کد ارز |
| network* | string | - | کد شبکه فاکتور |
| uuid | stringuuid | رشته UUID تصادفی | UUID از فاکتور |
| order_id | stringmin:1max:32alpha_dash | رشته تصادفی | شناسه فاکتور را سفارش دهید |
| status* | string | paid | وضعیت پرداختگزینه های موجود:• process• check• paid• paid_over• fail• wrong_amount• cancel• system_fail• refund_process• refund_fail• refund_paid |
نوع پارامتری
stringmin:6max:150urlتعریف
URL که webhooks با وضعیت پرداخت به آن ارسال خواهد شدنوع پارامتری
stringتعریف
فاکتور کد ارزنوع پارامتری
stringتعریف
کد شبکه فاکتورنوع پارامتری
stringuuidمقدار پیش فرض
رشته UUID تصادفیتعریف
UUID از فاکتورنوع پارامتری
stringmin:1max:32alpha_dashمقدار پیش فرض
رشته تصادفیتعریف
شناسه فاکتور را سفارش دهیدنوع پارامتری
stringمقدار پیش فرض
paidتعریف
وضعیت پرداختگزینه های موجود:- 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/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}پرداخت تست
برای اعتبارسنجی امضا از آرایه داده Webhook ، از کلید API پرداخت استفاده کنید.
درخواست
پارامترهای پرس و جو
| نام | نوع پارامتری | مقدار پیش فرض | تعریف |
|---|---|---|---|
| url_callback* | stringmin:6max:150url | - | URL که webhooks با وضعیت پرداخت به آن ارسال خواهد شد |
| currency* | string | - | کد ارز پرداخت |
| network* | string | - | کد شبکه پرداخت |
| uuid | stringuuid | رشته UUID تصادفی | UUID پرداخت |
| order_id | stringmin:1max:32alpha_dash | رشته تصادفی | شناسه پرداخت پرداخت |
| status* | string | paid | وضعیت پرداختگزینه های موجود:• process• check• paid• fail• cancel• system_fail |
نوع پارامتری
stringmin:6max:150urlتعریف
URL که webhooks با وضعیت پرداخت به آن ارسال خواهد شدنوع پارامتری
stringتعریف
کد ارز پرداختنوع پارامتری
stringتعریف
کد شبکه پرداختنوع پارامتری
stringuuidمقدار پیش فرض
رشته UUID تصادفیتعریف
UUID پرداختنوع پارامتری
stringmin:1max:32alpha_dashمقدار پیش فرض
رشته تصادفیتعریف
شناسه پرداخت پرداختنوع پارامتری
stringمقدار پیش فرض
paidتعریف
وضعیت پرداختگزینه های موجود:- process- check- paid- fail- cancel- system_fail
* - پارامتر اجباری
مثال
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}کیف پول تست
برای اعتبارسنجی امضا از آرایه داده Webhook ، از کلید API پرداخت استفاده کنید.
درخواست
پارامترهای پرس و جو
| نام | نوع پارامتری | مقدار پیش فرض | تعریف |
|---|---|---|---|
| url_callback* | stringmin:6max:150url | - | URL که webhooks با وضعیت پرداخت به آن ارسال خواهد شد |
| currency* | string | - | کد ارز پرداخت |
| network* | string | - | کد شبکه پرداخت |
| uuid | stringuuid | رشته UUID تصادفی | کیف پول تجارت |
| order_id | stringmin:1max:32alpha_dash | رشته تصادفی | شناسه فاکتور را سفارش دهید |
| status* | string | paid | وضعیت پرداختگزینه های موجود:• process• check• paid• paid_over• fail• wrong_amount• cancel• system_fail• refund_process• refund_fail• refund_paid |
نوع پارامتری
stringmin:6max:150urlتعریف
URL که webhooks با وضعیت پرداخت به آن ارسال خواهد شدنوع پارامتری
stringتعریف
کد ارز پرداختنوع پارامتری
stringتعریف
کد شبکه پرداختنوع پارامتری
stringuuidمقدار پیش فرض
رشته UUID تصادفیتعریف
کیف پول تجارتنوع پارامتری
stringmin:1max:32alpha_dashمقدار پیش فرض
رشته تصادفیتعریف
شناسه فاکتور را سفارش دهیدنوع پارامتری
stringمقدار پیش فرض
paidتعریف
وضعیت پرداختگزینه های موجود:- 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}