eBay大中华区API开发者平台 开发者专区

搜 索

Finances API 的概念和用法

发布时间:2022-07-22 18:09:01

卖家加入eBay管理支付之后将由eBay向卖家提供资金管理的服务。

本文将介绍Finances API中几个调用的常规用法,卖家可以通过下述一些API调用获取自己帐号的财务信息。


本文介绍内容:

一. 资金池

二. 资金流水

三. 发款

四. 对账

五. 关联订单的资金流水

六. 其他费用


一. 资金池(点击回到介绍内容

eBay 网页界面卖家可以访问自己帐号的卖家专区,点击【我的eBay】下拉菜单【出售中的物品】选项:(如图所示)


通过点击【付款】下拉菜单【摘要】选项浏览财务资金情况:(如图所示)


getSellerFundsSummary获取卖家帐号的资金汇总:

GET https://apiz.ebay.com/sell/finances/v1/seller_funds_summary

结合上图资金汇总,可用资金没有返回的原因是额度为0


可用资金以及冻结资金总和即资金总额,也就是我们所述的资金池。

冻结资金可能会被解冻从而转变成可用资金。

可用资金会在指定的发款时间节点进入卖家关联的Payoneer账户。


Tips

这些资金都是以美元USD币种结算,卖家可以通过Payoneer换算汇率后将账户中的资金再转向个人银行卡。

 

二. 资金流水点击回到介绍内容

新成交的一个订单资金会先流入冻结资金;冻结资金中有一部分解冻了会流入可用资金;先前某一笔订单执行了退款后,可用资金就会变少;当发款时间点到了,可用资金进入卖家的Payoneer账户。

资金流水的存在使得资金池总是变化着。

 

资金流水五要素:

transactionId:资金流水号

transactionType:资金流水的类型

amount.value:资金流水结算金额

bookingEntry:资金流水的流向

transactionStatus:资金流水的状态

 

无论数据结构多么复杂,只要抓住上述五个要素就能快速知晓这笔资金流水的基本信息。


Example 1

一笔资金流水总是以transactionId开头,

提取五个要素

"transactionId": "01-08844-46352",

"transactionType": "SALE"

"amount": {

                "value": "4.76",

                "currency": "USD"

 }

"bookingEntry": "CREDIT",

"transactionStatus": "FUNDS_ON_HOLD"

结合起来概括即编号为01-08844-46352的订单销售类型资金流水USD4.76eBay流向卖家的资金池,当前还在冻结资金中。


Example 2

 

提取五个要素:

"transactionId": "FEE-4159278863918",

"transactionType": "NON_SALE_CHARGE"

"amount": {

                "value": "5.0",

                "currency": "USD"

 }

"bookingEntry": "DEBIT",

"transactionStatus": "PAYOUT"

 

结合起来概括即编号为FEE-4159278863918的非交易类费用资金流水USD5.0由卖家的资金池流向eBay,当前已计入发款Payout

 

getTransactions获取卖家的资金流水:

GET https://apiz.ebay.com/sell/finances/v1/transaction

 

三. 发款点击回到介绍内容

卖家可以在eBay设定自己的发款时间:(如图所示)

 


卖家资金池中的可用资金将于指定的发款时间点发款至Payoneer账户。

这个发款亦称之为Payout,每一期发款都有独一无二的Payout ID

点击【付款】下拉菜单中的【收款】选项即可查看:(如图所示)


getPayouts以及getPayout获取发款信息:

GET https://apiz.ebay.com/sell/finances/v1/payout

(这个call可以返回默认最近20次的发款)

可以看到该卖家帐号目前只有一次发款,Payout ID 以及金额与上图能对应上:(如图所示)

 


GET https://apiz.ebay.com/sell/finances/v1/payout/payoutId

如果知道Payout ID也可以查看某期发款的信息:(如图所示)


四. 对账点击回到介绍内容

对账是每个卖家都非常关心的环节,因为需要确认eBay的发款金额是否正确。

即:收入多少(包括明细)以及支出多少(包括明细)。


点击【付款】下拉菜单的【报告】选项进入报告页面:(如图所示)


选择开始和结束日期后就可以创建交易报告并下载:(如图所示)


打开下载的交易报告,涵盖指定日期时间段内所有的资金流水。

交易报告中有非常多的字段列,但我们只需用到其中一部分字段列来对账:(如图所示)


getTransactions 获取指定日期时间段的资金流水

如果要完全匹配交易报告的日期时间,请注意时差转换:(如图所示)


当然卖家还有另一种对账方式,在发款界面点击某个发款编号(Payout ID) :(如图所示)

 

明细界面可以看到该发款所有相关的资金流水,并点击下载报告:(如图所示)


交易报告所有资金流水只跟这个发款编号有关:(如图所示)

 


getTransactions 获取某个发款编号的资金流水(如图所示)


五. 关联订单的资金流水点击回到介绍内容

卖家点击【付款】下拉菜单的【全部交易】选项后,选择过滤订单编号就能查看该订单关联的所有资金流水。

如下图所示,可以看到这个订单关联了售出和退款两部分,

当然还能进一步查看其中的明细。


getTransaction获取订单相关的资金流水

设置订单编号作为过滤条件即可获取上述eBay页面展示的资金流水明细信息:(如图所示)


六. 其他费用点击回到介绍内容

卖家点击【付款】下拉菜单的【全部交易】选项后,选择类型过滤为其他费用。

在上一个环节中我们阐述了关联订单出现的三个常规交易费用,

此类跟订单无关的费用,称之为NON_SALE_CHARGE


getTransaction获取非交易类型费用

设置过滤条件transactionTypeNON_SALE_CHARGE

当某个费用资金流水同时满足以下两个条件,就可以认定它是一个非交易类型的费用了:

1transactionType:NON_SALE_CHARGE

2. 不会关联到任何订单号OrderId

 



Tips

对比eBay页面显示的费用中文名称,API接口返回的费用却是英文名称。

可以利用Trading API下的getAccount来巧取;当然这不属于本期Finances API的介绍范畴,

例如feeType: RESERVE_PRICE_FEE 的中文名称:(如图所示)

transactionId : Fee-4159278863918

ItemID: 18547521****



更多的Fee Type种类,请参考如下链接:

https://developer.ebay.com/api-docs/sell/finances/types/api:FeeTypeEnum