Prueba de webhook

Prueba de prueba

post

https://api.cryptomus.com/v1/test-webhook/payment

COPIAR

Para validar la firma de la matriz de datos de Webhook, use la clave API de pago.

Para asegurarse de que está recibiendo correctamente los webhooks y puede validar la firma, debe usar este método para probar los webhooks para el pago.
Tenga en cuenta que no se guarda datos en la base de datos, y los datos recibidos en el Webhook solo se almacenan en una matriz con fines de prueba para garantizar la corrección de la firma y probar la recuperación de esta matriz de nosotros.

Para probar un webhook con una factura existente, proporcione su UUID u ID de pedido. Si no se proporcionan estos parámetros, el webhook se enviará con una factura de prueba.

Pedido

Parámetros de consulta

Nombre	Tipo de parámetro	Valor por defecto	Definición
url_callback*	stringmin:6max:150url		URL a la que se enviarán los webhooks con estado de pago
currency*	string		Código de moneda de factura
network*	string		Código de red de facturas
uuid	stringuuid	cadena uuid aleatoria	uuid de la factura
order_id	stringmin:1max:32alpha_dash	cadena aleatoria	ID de pedido de la factura
status*	string	paid	Estado de pagoOpciones Disponibles:• process• check• paid• paid_over• fail• wrong_amount• cancel• system_fail• refund_process• refund_fail• refund_paid

Tipo de parámetro

stringmin:6max:150url

Definición

URL a la que se enviarán los webhooks con estado de pago

Tipo de parámetro

string

Definición

Código de moneda de factura

Tipo de parámetro

string

Definición

Código de red de facturas

Tipo de parámetro

stringuuid

Definición

uuid de la factura

Tipo de parámetro

stringmin:1max:32alpha_dash

Definición

ID de pedido de la factura

Tipo de parámetro

string

Definición

Estado de pagoOpciones Disponibles:- process- check- paid- paid_over- fail- wrong_amount- cancel- system_fail- refund_process- refund_fail- refund_paid

* - parámetro obligatorio

Puede pasar uno de los parámetros UUID u Order_ID, si pasa ambos, la cuenta será identificada por UUID

Ejemplo de solicitud


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"
}'

COPIAR

Respuesta

Ejemplo de respuesta


1{
2  "state": 0,
3  "result": []
4}

COPIAR

Pago de pruebas

post

https://api.cryptomus.com/v1/test-webhook/payout

COPIAR

Para validar la firma de la matriz de datos de Webhook, use la clave API de pago.

Pedido

Parámetros de consulta

Nombre	Tipo de parámetro	Valor por defecto	Definición
url_callback*	stringmin:6max:150url		URL a la que se enviarán los webhooks con estado de pago
currency*	string		Código de moneda de pago
network*	string		Código de red de pago
uuid	stringuuid	cadena uuid aleatoria	uuid del pago
order_id	stringmin:1max:32alpha_dash	cadena aleatoria	ID de pedido del pago
status*	string	paid	Estado de pagoOpciones Disponibles:• process• check• paid• fail• cancel• system_fail

Tipo de parámetro

stringmin:6max:150url

Definición

URL a la que se enviarán los webhooks con estado de pago

Tipo de parámetro

string

Definición

Código de moneda de pago

Tipo de parámetro

string

Definición

Código de red de pago

Tipo de parámetro

stringuuid

Definición

uuid del pago

Tipo de parámetro

stringmin:1max:32alpha_dash

Definición

ID de pedido del pago

Tipo de parámetro

string

Definición

Estado de pagoOpciones Disponibles:- process- check- paid- fail- cancel- system_fail

* - parámetro obligatorio

Puede pasar uno de los parámetros UUID u Order_ID, si pasa ambos, la cuenta será identificada por UUID

Ejemplo de solicitud


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"
}'

COPIAR

Respuesta

Ejemplo de respuesta


1{
2  "state": 0,
3  "result": []
4}

COPIAR

Billetera de prueba

post

https://api.cryptomus.com/v1/test-webhook/wallet

COPIAR

Para validar la firma de la matriz de datos de Webhook, use la clave API de pago.

Pedido

Parámetros de consulta

Nombre	Tipo de parámetro	Valor por defecto	Definición
url_callback*	stringmin:6max:150url		URL a la que se enviarán los webhooks con estado de pago
currency*	string		Código de moneda de pago
network*	string		Código de red de pago
uuid	stringuuid	cadena uuid aleatoria	uuid de billetera de negocios
order_id	stringmin:1max:32alpha_dash	cadena aleatoria	ID de pedido de la factura
status*	string	paid	Estado de pagoOpciones Disponibles:• process• check• paid• paid_over• fail• wrong_amount• cancel• system_fail• refund_process• refund_fail• refund_paid

Tipo de parámetro

stringmin:6max:150url

Definición

URL a la que se enviarán los webhooks con estado de pago

Tipo de parámetro

string

Definición

Código de moneda de pago

Tipo de parámetro

string

Definición

Código de red de pago

Tipo de parámetro

stringuuid

Definición

uuid de billetera de negocios

Tipo de parámetro

stringmin:1max:32alpha_dash

Definición

ID de pedido de la factura

Tipo de parámetro

string

Definición

Estado de pagoOpciones Disponibles:- process- check- paid- paid_over- fail- wrong_amount- cancel- system_fail- refund_process- refund_fail- refund_paid

* - parámetro obligatorio

Ejemplo de solicitud


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"
}'

COPIAR

Respuesta

Ejemplo de respuesta


1{
2  "state": 0,
3  "result": []
4}

COPIAR

Posibles errores

Errores de validación

código : 422

Respuestas de ejemplo:

Si pasa uuid o orden_id y no se encuentra la factura/billetera estática/pago:


1{
2    "state": 1,
3    "message": "Not found payment"
4}

COPIAR


1{
2    "state": 1,
3    "message": "Not found payout"
4}

COPIAR


1{
2    "state": 1,
3    "message": "Not found wallet"
4}

COPIAR

Si no pasa los parámetros requeridos:


1{
2	"state": 1,
3	"errors": {
4		"currency": ["validation.required"]
5	}
6}

COPIAR

Si la moneda y la red proporcionadas no son cripto o no son compatibles:


1{
2    "state": 1,
3    "message": "Payment service not found"
4}

COPIAR


1{
2    "state": 1,
3    "message": "Payout service not found"
4}

COPIAR