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
Valor por defecto
null
Definición
Filterung durch Erschaffungsdatum von
: Tipo de parámetro
stringformat: YYYY-MM-DD H:mm:ss
Valor por defecto
null
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	Tipo de parámetro	Definición
merchant_uuid	string	Uuid del comerciante
items		Variedad de pagos. Estructura
paginate		Datos para la paginación. Estructura

: Tipo de parámetro
string
Definición
Uuid del comerciante
: Definición
Variedad de pagos. Estructura
: Definición
Datos para la paginación. Estructura

Estructura de artículo

Nombre	Tipo de parámetro	Definición
uuid	string	uuid del pago
amount	string	Monto de pago en currency
currency	string	Código de moneda para el pago
network	string\|null	El código de la red blockchain en la que se realiza el pago
payer_currency	string\|null	Código de criptomonedas en el que se realizará realmente el pago. La dirección de pago recibirá la moneda de pago.
payer_amount	string\|null	Cantidad en payer_currency del pago.
address	string	La dirección de la billetera a la que se realiza el pago
txid	string\|null	ID de transacción en la cadena de bloques
status	string	Estado de pago estado
payment_status	string	Estado de pago
is_final	boolean	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	string\|null	Los fondos restantes en la billetera del comerciante.
order_id	string\|null	ID de pedido en su sistema
commission	string\|null	Cantidad de la Comisión Cryptomus
merchant_amount	string\|null	La cantidad que se debita del saldo del comerciante, incluidas todas las comisiones.
created_at	string\|null	Fecha de creación del pago. La zona horaria es UTC+3
updated_at	string\|null	Último pago Fecha actualizada. La zona horaria es UTC+3
convert		La información sobre la moneda a la que el pago se convertirá automáticamente. La conversión se realiza desde payer_currency a USDTPresente si se pasa from_currency
convert.to_currency	string\|null	El código de moneda al que se convertirá el pago
convert.from_currency	string	De la moneda
convert.commission	string	Tarifa de conversión
convert.rate	string\|null	Tasa de conversión
convert.from_amount	string\|null	Monto desde

: Tipo de parámetro
string
Definición
uuid del pago
: Tipo de parámetro
string
Definición
Monto de pago en currency
: Tipo de parámetro
string
Definición
Código de moneda para el pago
: Tipo de parámetro
string|null
Definición
El código de la red blockchain en la que se realiza el pago
: Tipo de parámetro
string|null
Definición
Código de criptomonedas en el que se realizará realmente el pago. La dirección de pago recibirá la moneda de pago.
: Tipo de parámetro
string|null
Definición
Cantidad en payer_currency del pago.
: Tipo de parámetro
string
Definición
La dirección de la billetera a la que se realiza el pago
: Tipo de parámetro
string|null
Definición
ID de transacción en la cadena de bloques
: Tipo de parámetro
string
Definición
Estado de pago estado
: Tipo de parámetro
string
Definición
Estado de pago
: Tipo de parámetro
boolean
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.
: Tipo de parámetro
string|null
Definición
Los fondos restantes en la billetera del comerciante.
: Tipo de parámetro
string|null
Definición
ID de pedido en su sistema
: Tipo de parámetro
string|null
Definición
Cantidad de la Comisión Cryptomus
: Tipo de parámetro
string|null
Definición
La cantidad que se debita del saldo del comerciante, incluidas todas las comisiones.
: Tipo de parámetro
string|null
Definición
Fecha de creación del pago. La zona horaria es UTC+3
: Tipo de parámetro
string|null
Definición
Último pago Fecha actualizada. La zona horaria es UTC+3
: Definición
La información sobre la moneda a la que el pago se convertirá automáticamente. La conversión se realiza desde payer_currency a USDTPresente si se pasa from_currency
: Tipo de parámetro
string|null
Definición
El código de moneda al que se convertirá el pago
: Tipo de parámetro
string
Definición
De la moneda
: Tipo de parámetro
string
Definición
Tarifa de conversión
: Tipo de parámetro
string|null
Definición
Tasa de conversión
: Tipo de parámetro
string|null
Definición
Monto desde

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	"merchant_uuid": "8b03432e-385b-4670-8d06-064591096795",
5	"items": [{
6		"uuid": "a7c0caec-a594-4aaa-b1c4-77d511857594",
7		"amount": "3",
8		"currency": "USDT",
9		"network": "TRON",
10		"payer_currency": "USDT",
11		"payer_amount": "3",
12		"address": "TJ...",
13		"txid": null,
14		"status": "process",
15		"payment_status": "process",
16		"is_final": false,
17		"balance": "129.00000000",
18		"order_id": "1",
19		"commission": null,
20		"merchant_amount": null,
21		"created_at": "2023-06-21T17:25:55+03:00",
22		"updated_at": "2023-06-21T17:34:38+03:00"
23	}, {
24		"uuid": "92c39264-d180-4503-9c16-ee16f083bbb8",
25		"amount": "5.40000000",
26		"currency": "DOGE",
27		"network": "doge",
28		"payer_currency": "DOGE",
29		"payer_amount": "5.40000000",
30		"address": "DEw8CJLfxg9fhumeXP1zvVNjZicsqtDv7V",
31		"txid": "5e5810946152ea569d2a2aa9aa32a45c0e4223a4f9aad8e31d2fc660d2cdedb8",
32		"status": "paid",
33		"payment_status": "paid",
34		"is_final": true,
35		"balance": "26.77966652",
36		"order_id": null,
37		"commission": "0.00000000",
38		"merchant_amount": "5.40000000",
39		"created_at": "2023-07-21T17:25:55+03:00",
40		"updated_at": "2023-07-21T17:34:38+03:00"
41	},
42	...
43	],
44	"paginate": {
45		"count": 15,
46		"hasPages": true,
47		"nextCursor": "eyJpZCI6MjkxNTU0MywiX3BvaW50c1RvTmV4dEl0ZW1zIjp0cnVlfQ",
48		"previousCursor": null,
49		"perPage": 15
50	}
51}
52}

Copiar

Posibles errores

Errores de validación

código : 422

Ejemplos de respuestas:

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