Historial de pago

post

https://api.cryptomus.com/v1/payout/list

COPIAR

Pedido

Parámetros de consulta

Nombre	Tipo de parámetro	Valor por defecto	Definición
date_from	stringformat: YYYY-MM-DD H:mm:ss	null	Filterung durch Erschaffungsdatum von
date_to	stringformat: YYYY-MM-DD H:mm:ss	null	Filtrado por fecha de creación, para

Tipo de parámetro

stringformat: YYYY-MM-DD H:mm:ss

Definición

Filterung durch Erschaffungsdatum von

Tipo de parámetro

stringformat: YYYY-MM-DD H:mm:ss

Definición

Filtrado por fecha de creación, para

Ejemplo de solicitud


curl https://api.cryptomus.com/v1/payout/list \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: f80fa426a89eb62bd53997326865d850' \
-H 'Content-Type: application/json'

COPIAR

Para filtrar los pagos por fecha de creación del 4 al 16 de mayo.


curl https://api.cryptomus.com/v1/payout/list \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: f80fa426a89eb62bd53997326865d850' \
-H 'Content-Type: application/json' \
-d '{
	"date_from": "2023-05-04 00:00:00"
	"date_to": "2023-05-16 23:59:59"
}'

COPIAR

Respuesta

Parámetros de respuesta

Nombre	Definición
merchant_uuid	Uuid del comerciante
items	Variedad de pagos. Estructura
paginate	Datos para la paginación. Estructura

: Definición
Uuid del comerciante
: Definición
Variedad de pagos. Estructura
: Definición
Datos para la paginación. Estructura

Estructura de artículo

Nombre	Definición
uuid	uuid del pago
amount	Monto de pago en currency
currency	Código de moneda para el pago
network	El código de la red blockchain en la que se realiza el pago
address	La dirección de la billetera a la que se realiza el pago
txid	ID de transacción en la cadena de bloques
status	Estado de pago estado
is_final	Si el pago está finalizadoEl proceso de pago se considera finalizado una vez que se ha pagado con éxito o si ha fallado. En el caso de una falla de pago, los fondos serán devueltos a su saldo, lo que requiere que inicie el proceso de pago nuevamente.
balance	Los fondos restantes en la billetera del comerciante.
created_at	Fecha de creación del pago. La zona horaria es UTC+3
updated_at	Último pago Fecha actualizada. La zona horaria es UTC+3

: Definición
uuid del pago
: Definición
Monto de pago en currency
: Definición
Código de moneda para el pago
: Definición
El código de la red blockchain en la que se realiza el pago
: Definición
La dirección de la billetera a la que se realiza el pago
: Definición
ID de transacción en la cadena de bloques
: Definición
Estado de pago estado
: Definición
Si el pago está finalizadoEl proceso de pago se considera finalizado una vez que se ha pagado con éxito o si ha fallado. En el caso de una falla de pago, los fondos serán devueltos a su saldo, lo que requiere que inicie el proceso de pago nuevamente.
: Definición
Los fondos restantes en la billetera del comerciante.
: Definición
Fecha de creación del pago. La zona horaria es UTC+3
: Definición
Último pago Fecha actualizada. La zona horaria es UTC+3

Para obtener las entradas de página siguiente/anterior, especifique el hash del cursor siguiente/anterior en los parámetros de consulta (?cursor=nextCursorHash)

Ejemplo:


1curl https://api.cryptomus.com/v1/payout/list?cursor=eyJpZCI6MjEyLCJf cG9pbnRzVzVG9OZXh0SXRlbXMiOnRydWV9 \
2-X POST \
3-H 'merchant: cb2131ff-a3d4-46dd-94c6-3714fae65f89' \
4-H 'sign: f80fa426a89eb62bd53997326865d850' \
5-H 'Content-Type: application/json' \
6

COPIAR

Ejemplo de respuesta


1{
2"state": 0,
3"result": {
4	"items": [{
5		"uuid": "a7c0caec-a594-4aaa-b1c4-77d511857594",
6		"amount": "3",
7		"currency": "USDT",
8		"network": "TRON",
9		"address": "TJ...",
10		"txid": null,
11		"status": "process",
12		"is_final": false,
13		"balance": "129.00000000",
14		"created_at": "2023-06-21T17:25:55+03:00",
15		"updated_at": "2023-06-21T17:34:38+03:00"
16	}, {
17		"uuid": "92c39264-d180-4503-9c16-ee16f083bbb8",
18		"amount": "5.40000000",
19		"currency": "DOGE",
20		"network": "doge",
21		"address": "DEw8CJLfxg9fhumeXP1zvVNjZicsqtDv7V",
22		"txid": "5e5810946152ea569d2a2aa9aa32a45c0e4223a4f9aad8e31d2fc660d2cdedb8",
23		"order_id": null,
24		"payment_status": null,
25		"status": "paid",
26		"is_final": true,
27		"balance": "26.77966652",
28		"created_at": "2023-07-21T17:25:55+03:00",
29		"updated_at": "2023-07-21T17:34:38+03:00"
30	},
31	...
32	],
33	"paginate": {
34		"count": 15,
35		"hasPages": true,
36		"nextCursor": "eyJpZCI6MjkxNTU0MywiX3BvaW50c1RvTmV4dEl0ZW1zIjp0cnVlfQ",
37		"previousCursor": null,
38		"perPage": 15
39	}
40}
41}

COPIAR

Posibles errores

Errores de validación

código : 422

Respuestas de ejemplo:

Si el parámetro date_from o date_to se pasa en el formato incorrecto.


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

COPIAR