API REFERENCE
Informes de liquidación
Parámetros
| Parameter | Type | Descripción | Obligatorio |
|---|---|---|---|
| data.command | string | getTradebill | ✓ |
| data.bill_date | string | 账单日期 格式dd-MM-yyyy 仅支持三个月内的账单下载申请。 | ✓ |
| data.nonce_string | string | 随机字符串，不长于32位 | ✓ |
Esta API obtiene los informes de liquidación de YabandPay.
Consejo
- YabandPay liquida diariamente todas las transacciones del día anterior a las 4 (hora de los Países Bajos) y genera los informes. Recomendamos consultarlos después de las 7 (hora de los Países Bajos).
- Se genera diariamente un informe de liquidación por cada tienda y método de pago. Por ejemplo, una tienda con dos métodos de pago recibe 2 informes al día.
- Solo las cuentas de superadminestrador del comercio pueden llamar a esta API. Las cuentas de operador y cajero no tienen autorización para hacerlo.
| Parámetro | Tipo | Descripción | Obligatorio |
|---|---|---|---|
| user | String | UID de la cuenta de superadminestrador | Obligatorio |
| sign | String | Signature | Obligatorio |
| method | String | v3.GetTradebill | Obligatorio |
| time | Long | Timestamp | Obligatorio |
- Parámetros
| Parámetro | Tipo | Descripción | Obligatorio |
|---|---|---|---|
| command | String | getTradebill | Obligatorio |
| bill_date | String | Fecha de factura en formato dd-MM-yyyy. Las solicitudes de descarga solo se admiten para facturas de los últimos tres meses. | Obligatorio |
| nonce_string | String | Cadena aleatoria de un máximo de 32 caracteres | Obligatorio |
Ejemplo de firma:
Parámetros ordenados y concatenados en una cadena de consulta con formato de URL
"bill_date=2024-02-19&command=getTradebill&method=v3.GetTradebill&nonce_string=tw5be5b7sry5prm96s&time=1708422208&user=036870"
Firme la cadena A con secret_key
La firma resultante es:
"YOUR_SIGNATURE"
Ejemplo de solicitud:
{
"user": "040268",
"sign": "YOUR_SIGNATURE",
"method": "v3.GetTradebill",
"time": 1708422208,
"data": {
"command": "getTradebill",
"bill_date": "19-02-2024",
"nonce_string": "tw5be5b7sry5prm96s"
}
}
Ejemplo de respuesta:
{
"status": true,
"code": 200,
"message": "",
"data": {
"tradebill": [
{
"time_zone": "GMT+1",
"MID": 102300,
"merchant_name": "Yaband Telecom B.V.",
"store_name": "YabandPay",
"sub_pay_method": "WeChat Pay",
"settlement_currency": "EUR",
"number_of_payment": 8,
"amount_of_payment": "53.25",
"number_of_refund": 0,
"amount_of_refund": "0.00",
"fee": "0.9",
"net_value": "52.35",
"vat": "0.19",
"state": "settled",
"transaction_date": "2024-02-19",
"due_date": "2024-02-21",
"settlement_date": "2024-02-21",
"clearing_id": "M20240220001503109569"
},
{
"time_zone": "GMT+1",
"MID": 102300,
"merchant_name": "Yaband Telecom B.V.",
"store_name": "YabandPay",
"sub_pay_method": "Alipay",
"settlement_currency": "EUR",
"number_of_payment": 9,
"amount_of_payment": "67.85",
"number_of_refund": 0,
"amount_of_refund": "0.00",
"fee": "1.23",
"net_value": "66.62",
"vat": "0.20",
"state": "settled",
"transaction_date": "2024-02-19",
"due_date": "2024-02-21",
"settlement_date": "2024-02-21",
"clearing_id": "M20240220001503109614"
}
],
"count": 2
}
}
Información adicional:
Descripción de los parámetros de respuesta:
| Parámetro | Tipo | Descripción |
|---|---|---|
| time_zone | String | Zona horaria de liquidación, usually the time zone of the merchant's country of regestration |
| MID | String | Merchant's MID |
| merchant_name | String | Nombre del comercio |
| store_name | String | Nombre de la tienda del comercio |
| sub_pay_method | String | Método de pago |
| settlement_currency | String | Moneda de liquidación, ISO 4217 |
| number_of_payment | String | Número de transacciones de pago |
| amount_of_payment | String | Importe total de las transacciones de pago |
| number_of_refund | String | Number of refund transactions |
| amount_of_refund | String | Total refund transaction amount |
| fee | String | Transaction fees |
| net_value | String | Net transaction value before VAT deduction |
| vat | String | VAT on all transaction fees |
| state | String | Settlement status: processing or settled |
| transaction_date | String | Date the transaction occurred |
| due_date | String | Expected settlement date |
| settlement_date | String | Actual settlement date |
| clearing_id | String | Clearing ID |
| count | String | Number of records returned |