列示所有操作

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

以不同数据格式获取指定数据范围/传输/报告的所有交易的信息。将在API的响应中返回JSON、CSV或XLS。

注意

此API调用不包含project_id路径参数，因此您需要使用在您公司的所有项目中都有效的API密钥来设置授权。

SecuritybasicAuth

Request

path Parameters

merchant_id required	integer 商户ID。
format required	string 数据格式。 Enum: "json" "csv" "xls"

query Parameters

datetime_from

required

string <datetime>

YYYY-MM-DD格式的开始时间段。如传入了limit参数，此参数非必需。

Example: datetime_from=2023-02-08

datetime_to

required

string <datetime>

YYYY-MM-DD格式的结束时间段。如传入了limit参数，此参数非必需。datetime_from和datetime_to之间不能超过92天。

Example: datetime_to=2023-03-08

in_transfer_currency

required

integer

是否用支出币种（默认为支付币种）显示所有财务数据。

show_total

required

boolean

是否在文件结尾添加总计值行。

merchant_of_records

string or null

在册商户。可以是xsolla、merchant或不指定。如果为merchant，则返回通过合作伙伴直接帐户进行的交易。如果为xsolla，则返回非通过合作伙伴直接帐户进行的交易。如未指定，则返回所有交易。

Enum:	Description
merchant	返回通过合作伙伴直接帐户进行的交易。
xsolla	返回非通过合作伙伴直接帐户进行交易。

project_id

integer

项目ID。

show_dry_run

boolean

是否包括测试交易。

transfer_id

integer

交易传输 ID。

report_id

integer

财务报告 ID。

offset

integer

元素编号，从该元素开始生成列表（从0开始数）。

limit

integer

页面上显示的交易数限制。如传入了此参数，则不必传入datetime_from和datetime_to参数。

status

string

交易状态。

Enum: "done" "canceled" "error"

Responses

200

交易列表已成功返回。

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,
"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": "a.smith",
"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
}
}
}
]