Creando una factura

Pedido

Parámetros de consulta

* - parámetro obligatorio

Estructura de Monedas

* - parámetro obligatorio

Estructura de except_currencies

* - parámetro obligatorio

Ejemplo de solicitud

A continuación se muestra un ejemplo de muestra con el número mínimo requerido de parámetros. En este caso, se creará una factura con la moneda Fiat USD. En la página de pago, el usuario podrá seleccionar la criptomoneda y la red para pagar esta factura.

curl https://api.cryptomus.com/v1/payment \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{
	"amount": "15",
	"currency": "USD",
	"order_id": "1"
}'

Respuesta

Parámetros de respuesta

Ejemplo de respuesta

1{
2	"state": 0,
3	"result": {
4		"uuid": "26109ba0-b05b-4ee0-93d1-fd62c822ce95",
5		"order_id": "1",
6		"amount": "15.00",
7		"payment_amount": null,
8		"payer_amount": null,
9		"discount_percent": null,
10		"discount": "0.00000000",
11		"payer_currency": null,
12		"currency": "USD",
13		"merchant_amount": null,
14		"network": null,
15		"address": null,
16		"from": null,
17		"txid": null,
18		"payment_status": "check",
19		"url": "https://pay.cryptomus.com/pay/26109ba0-b05b-4ee0-93d1-fd62c822ce95",
20		"expired_at": 1689098133,
21		"status": "check",
22		"is_final": false,
23		"additional_data": null,
24		"created_at": "2023-07-11T20:23:52+03:00",
25		"updated_at": "2023-07-11T21:24:17+03:00"
26	}
27}

Más ejemplos

Solicite datos para crear una factura para 20 USDT en la red Tron. La factura tendrá una dirección en el momento de la creación.

1{
2	"amount": "20",
3	"currency": "USDT",
4	"order_id": "1",
5	"network": "tron"
6}

Solicite datos para crear una factura para 25 USD y permita a los clientes pagar solo por USDT en cualquier red.

1{
2	"amount": "25",
3	"currency": "USD",
4	"order_id": "1",
5	"to_currency": "USDT"
6}

Solicite datos para crear una factura para 25 USD y permita a los clientes pagar solo por USDT en Tron Network. La factura tendrá una dirección en el momento de la creación.

1{
2	"amount": "25",
3	"currency": "USD",
4	"order_id": "1",
5	"to_currency": "USDT",
6	"network": "tron"
7}

Solicite datos para crear una factura para 20 USDT y permitir a los clientes pagar en todas las redes disponibles

1{
2	"amount": "20",
3	"currency": "USDT",
4	"order_id": "1"
5}

Solicite datos para crear una factura para 20 USD y permita a los clientes pagar solo en bitcoin. La factura tendrá una dirección en el momento de la creación.

1{
2	"amount": "20",
3	"currency": "USD",
4	"order_id": "1",
5	"to_currency": "BTC"
6}

Solicite datos para crear una factura para 0.5 BTC y permita a los clientes pagar solo en bitcoin. La factura tendrá una dirección en el momento de la creación.

1{
2	"amount": "0.5",
3	"currency": "BTC",
4	"order_id": "1"
5}

Posibles errores

Errores de validación

código : 422

Respuestas de ejemplo:

Si se requiere algún parámetro y no se pasa:

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

Si proporcionó el código de red que no es compatible

1{
2    "state": 1,
3    "message": "The network was not found"
4}

Si no admitimos el código de divisas que proporcionó en el parámetro moneda :

1{
2    "state": 1,
3    "message": "The currency was not found"
4}

Si sus pagos están bloqueados. En este caso, debe comunicarse con el soporte.

1{
2    "state": 1,
3    "message": "You are forbidden"
4}

Si no encontramos el servicio de pago de la moneda que se pasó en to_currency parámetro:

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

Si accidentalmente sucede algo al convertir a to_currency :

1{
2    "state": 1,
3    "message": "Error convert to_currency"
4}

Si el monto del pago es menor que el monto mínimo compatible con la criptomoneda, recibirá este mensaje de error:

1{
2    "state": 1,
3    "message": "Minimum amount 0.5 USDT"
4}

Si el monto del pago es mayor que el monto máximo compatible para la criptomoneda, recibirá este mensaje de error:

1{
2    "state": 1,
3    "message": "Maximum amount 10000000 USDT"
4}

Si no tendrá una billetera comercial activa con una criptomoneda del pago, recibirá este error:

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

Si se produce un trabajo técnico y el pago no está disponible temporalmente, puede recibir estos mensajes de error:

1{
2    "state": 1,
3    "message": "Gateway error"
4}

1{
2    "state": 1,
3    "message": "The terminal was not found"
4}

1{
2    "state": 1,
3    "message": "Server error"
4}

Error Interno del Servidor

código : 500

Respuestas de ejemplo:

1{
2	"message": "Server error, #1",
3	"code": 500,
4	"error": null
5}