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
Valor por defecto
cadena uuid aleatoria
Definición
uuid de la factura
: Tipo de parámetro
stringmin:1max:32alpha_dash
Valor por defecto
cadena aleatoria
Definición
ID de pedido de la factura
: Tipo de parámetro
string
Valor por defecto
paid
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
Valor por defecto
cadena uuid aleatoria
Definición
uuid del pago
: Tipo de parámetro
stringmin:1max:32alpha_dash
Valor por defecto
cadena aleatoria
Definición
ID de pedido del pago
: Tipo de parámetro
string
Valor por defecto
paid
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
Valor por defecto
cadena uuid aleatoria
Definición
uuid de billetera de negocios
: Tipo de parámetro
stringmin:1max:32alpha_dash
Valor por defecto
cadena aleatoria
Definición
ID de pedido de la factura
: Tipo de parámetro
string
Valor por defecto
paid
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

Ejemplos de respuestas:

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