Obtener transacciones

Obtener transaccionesServer-sideAdmin

get/merchants/{merchant_id}/reports/transactions/registry.{format}

Devuelve la lista de detalles sobre las transacciones realizadas y canceladas durante un periodo especificado. Como respuesta, recibe información sobre los pagos, incluyendo datos sobre tasas, impuestos, así como sobre el pedido y el usuario. Puede obtener la lista en formato JSON o CSV. Puede usar esta llamada API para realizar conciliaciones financieras.

Aviso

Esta llamada API no contiene el parámetro de ruta project_id, por lo que tiene que usar la clave de API que sea válida en todos los proyectos de la empresa para establecer la autorización.

SecuritybasicAuth

Request

path Parameters

merchant_id required	integer ID de vendedor.
format required	string Formato de los datos. Enum: "json" "csv" "xls"

query Parameters

datetime_from

required

string <datetime>

Inicio del periodo en formato AAAA-MM-DD. No es necesario si se transmite el parámetro limit.

Example: datetime_from=2023-02-08

datetime_to

required

string <datetime>

Fin del periodo en formato AAAA-MM-DD. No es necesario si se transmite el parámetro limit. La diferencia entre datetime_from y datetime_to no puede ser superior a 92 días.

Example: datetime_to=2023-03-08

in_transfer_currency

required

integer

Convierte todos los datos financieros a la moneda de los desembolsos (por defecto se utiliza la moneda de los pagos entrantes).

show_total

required

boolean

Añade los totales al informe.

merchant_of_records

string or null

Comerciante titular. Puede ser xsolla, merchant o sin especificar. Si es merchant, devuelve las transacciones realizadas a través de las pasarelas del socio. Si es xsolla, devuelve las transacciones realizadas sin utilizar las pasarelas del socio. Si no se especifica, devuelve todas las transacciones.

Enum:	Description
merchant	Devuelve las transacciones realizadas a través de las pasarelas del socio.
xsolla	Devuelve las transacciones realizadas sin utilizar las pasarelas del socio.

project_id

integer

ID del proyecto.

show_dry_run

boolean

Si se deben incluir transacciones de prueba.

transfer_id

integer

ID del desembolso.

report_id

integer

ID del informe financiero.

offset

integer

Número del elemento a partir del cual se genera la lista (el conteo empieza desde el 0).

limit

integer

Límite del número de transacciones que se muestran en la página. Si se transmite este parámetro, no es necesario transmitir los parámetros datetime_from y datetime_to.

status

string

Estado de la transacción.

Enum: "done" "canceled" "error"

Responses

200

La lista de transacciones se ha devuelto correctamente.

Request samples

Response samples

application/json

[{"payment_details": {"chargebackPenalty": {"amount": 0
},
"commission_agent": {"amount": 0,
"percent": 0
},
"commission_agent_fixed": 0,
"commission_ps": {"amount": 0,
"fixed_amount": 0,
"percent": 0
},
"commission_ps_from_vat": {"amount": 0
},
"commission_user": {"amount": 0.01,
"percent": 33.33
},
"commission_xsolla": {"amount": 0,
"fixed_amount": 0,
"percent": 5
},
"cpa_network_commission": {"amount": 0,
"percent": 0
},
"direct_wht": {"amount": 0,
"percent": 0
},
"payment": {"amount": 0.03,
"amount_from_ps": 0,
"currency": "USD"
},
"payout": {"amount": 0.02,
"amount_from_ps": 0,
"currency": "RUB",
"fx_rate": 64.1386407767,
"percent": 100
},
"refundPenalty": {"amount": 0
},
"repatriation_costs": {"amount": 0,
"percent": 0
},
"sales_tax": {"amount": 0,
"percent": 0
},
"vat": {"amount": 0,
"percent": 0,
"user_amount": 0,
"user_percent": 0
}
},
"purchase": {"friend": {"email": null,
"user_id": null
},
"items_amount": 1,
"pin_codes": {"amount": null,
"content": null,
"currency": null
},
"purchase_amount": 0.02,
"simple_checkout": {"amount": null,
"currency": null
},
"subscription": {"name": null,
"plan_id": null,
"product_id": null,
"product_name": null,
"subscription_id": null
},
"virtual_currency": {"amount": 0.02,
"currency": "USD"
},
"virtual_currency_amount": 1,
"virtual_items": {"amount": null,
"content": null,
"currency": null
}
},
"transaction": {"custom_parameters": null,
"direct_account": 0,
"dry_run": 0,
"external_id": null,
"id": 418756634,
"payment_method": {"class": "Digital Payment Methods",
"id": 2760,
"name": "Your Balance"
},
"project": {"id": 21092,
"name": "Smith"
},
"refund_reason": null,
"refund_reason_comment": null,
"status": "done",
"transfer_date": "2019-02-11T13:32:00+03:00"
},
"user": {"country": "US",
"custom": null,
"email": "email@example.com",
"id": "smith123",
"ip": "209.11.22.33",
"marketplace": "Pay Station",
"name": "Tom",
"phone": null
},
"user_balance": {"payment_currency": {"deduction_amount": 0,
"payout_amount_from_balance": 0.02,
"purchase_amount_from_balance": 0.02
}
}
}
]