通过getTransfer接口查看转账信息
发布时间：2021-03-05 最近刷新时间：2021-03-05
eBay会自动计算卖家账户上的资金，包括即将收款的资金，和已经收款的资金等。在某些情况下，卖家的可用资金可能不足以支付退款（Refund）或费用（Fees）等类似款项，eBay会向卖家在账号中预设的信用卡进行一次转账（Transfer）。
通过getTransfer接口可以查看该转账的信息，包括关联了几笔退款，每笔退款具体的金额等。
注：
transferId和卖家在eBay网站的卖家专区“Payments”分页下，通过Transfer类型查看的Transfer ID并不相同，用于接口中可能会得到 404 not found的响应。
响应参数的transactionId即为transferId。
其中，通过fundingSource.type可判断这一笔转账的资金来源，可能是来源自卖家的可用资金，也可能是卖家绑定的信用卡或银行账户。而memo会给出相关信息，如银行卡号后四位数字。
transferAmount为这笔transfer的扣款金额，与另外两个参数有这样的关系：
transferAmount = totalChargeNetAmount – balanceAdjustment.amount 。
totalChargeNetAmount为所有的退款或类似交易对卖家的扣款之和，具体扣款可查看transferDetail.charges。
balanceAdjustment.amount为transfer发生时，卖家的账户可用资金，由于补足扣款，所以发生的transfer金额为两者的差值。
transferDetail.charges列出了所有本次转账需要补充的扣款资金明细，包括扣款类型和金额。目前扣款的来源有如下几种: cancel, case, inquiry, order, paymentDispute, refund, return。获得扣款类型和金额后，可以用于卖家的对账。
发布时间：2021-03-05 最近刷新时间：2021-03-05
eBay会自动计算卖家账户上的资金，包括即将收款的资金，和已经收款的资金等。在某些情况下，卖家的可用资金可能不足以支付退款（Refund）或费用（Fees）等类似款项，eBay会向卖家在账号中预设的信用卡进行一次转账（Transfer）。
通过getTransfer接口可以查看该转账的信息，包括关联了几笔退款，每笔退款具体的金额等。
获取transferId
使用getTransfer接口必须指定transferId。如果卖家不知道transferId，可以先通过getTransasctions接口，通过指定transactionType获取某段时间内所有的transferId，再逐一进行查看。注：
transferId和卖家在eBay网站的卖家专区“Payments”分页下，通过Transfer类型查看的Transfer ID并不相同，用于接口中可能会得到 404 not found的响应。
|
Resource URI (production) |
|
GET https://apiz.ebay.com/sell/finances/v1/transaction? limit=integer& offset=integer& filter=FilterField& sort=SortField |
|
URI parameters |
|
filter=transactionType:{TRANSFER} |
|
API reference |
|
https://developer.ebay.com/api-docs/sell/finances/resources/transaction/methods/getTransactions |
|
Request payload |
| 无 |
|
本案例需要的关键响应参数 |
| transactions.transactionId |
响应参数的transactionId即为transferId。
查看transfer详情
获取到transferId后，卖家可以通过getTransfer接口查看详情。
|
Resource URI (production) |
|
GET https://apiz.ebay.com/sell/finances/v1/transfer/{transfer_Id} |
|
URI parameters |
|
transferId={transfer_Id} |
|
API reference |
|
https://developer.ebay.com/api-docs/sell/finances/resources/transfer/methods/getTransfer |
|
Request payload |
| 无 |
|
本案例需要的关键响应参数 |
|
fundingSource.memo fundingSource.type transferAmount transferDetail.charges transferDetail.totalChargeNetAmount transferDetail.balanceAdjustment.amount |
其中，通过fundingSource.type可判断这一笔转账的资金来源，可能是来源自卖家的可用资金，也可能是卖家绑定的信用卡或银行账户。而memo会给出相关信息，如银行卡号后四位数字。
transferAmount为这笔transfer的扣款金额，与另外两个参数有这样的关系：
transferAmount = totalChargeNetAmount – balanceAdjustment.amount 。
totalChargeNetAmount为所有的退款或类似交易对卖家的扣款之和，具体扣款可查看transferDetail.charges。
balanceAdjustment.amount为transfer发生时，卖家的账户可用资金，由于补足扣款，所以发生的transfer金额为两者的差值。
transferDetail.charges列出了所有本次转账需要补充的扣款资金明细，包括扣款类型和金额。目前扣款的来源有如下几种: cancel, case, inquiry, order, paymentDispute, refund, return。获得扣款类型和金额后，可以用于卖家的对账。
