Wooshpay 可以向您的银行账户付款。您可以在控制面板上查看银行账户中的所有支付清单。此外，您还可以通过 API 获取付款列表。
付款状态 #
一个付款申请有五种状态。一旦创建了赔付，初始状态将是挂起。调用取消 API 时，状态将被取消，导致支付流程取消。当请求提交给银行时，状态将变为 in_transit。然后，状态会分解为两种可能性：如果银行处理失败，则会导致支付结果为 Failed；如果银行处理成功，则会导致支付状态。
支付速度 #
赔付时间表是指赔付资金的节奏（例如，每周的哪一天），而赔付速度是指资金可用所需的时间。支付速度因国家而异，通常用 T+X 天表示。有些支付处理商可能会从内部结算时间开始计算 "T"，即资金到达银行账户的时间。
T "指的是交易时间，即最初确认或捕获付款的时间。例如，如果您的账户所在国家的标准支付速度为 T+3，而您使用的是手动支付计划，则您的余额将在捕获支付后的 3 个工作日内可供支付。
最低支付金额 #
最低赔付金额通常为一个当地货币基本单位。例如，在美国，最低赔付额为一美元，而在新加坡，最低赔付额为一新元。
支付速度和最低金额 #
| 国家/地区 | 支付速度(工作日） | 最低金额（当地货币） | 最高金额（当地货币） |
|---|---|---|---|
| 香港 | 1-3 | 0.01 港元 | / |
| 日本 | 1-3 | 100.00 日元 | / |
| 韩国 | 1-3 | 1.00 韩元 | / |
| 欧洲联盟（单一欧元支付区） | 1-3 | 0.01 欧元 | / |
| 英国 | 1-3 | 0.01 英镑 | / |
| 美利坚合众国 | 1-3 | 0.01 美元 | / |
| 新西兰 | 1-3 | 0.01 新西兰元 | / |
| 澳大利亚 | 1-3 | 0.01 澳元 | / |
| 马来西亚 | 1-3 | 1.00 马币 | / |
| 新加坡 | 1-3 | 0.01 新元 | / |
| 韩国 | 1-3 | 1 韩元 | / |
| 泰国 | 1-3 | 10 泰铢 | 500000 泰铢 |
| 越南 | 1-3 | 10000 越南盾 | 300000000 越南盾 |
| 菲律宾 | 1-3 | 10 PHP | 500000 PHP |
| 印度尼西亚 | 1-3 | 10000 印尼盾 | 1000000000 IDR |
| 中国大陆 | 1-3 | 300 人民币 | / |
上表为标准情况。由于银行不同，支付速度可能会有差异，可能需要多花几天时间。企业类型和所在国家也会影响付款时间。
开始支付 #
您可以使用 Wooshpay API 创建支付。一般来说，有两种付款方式： 1.
- 全球支付
- 支付给中国
在创建支付之前，需要指定一些必要的参数：
受益人:如果是首次付款，则应在此对象中提供受益人详细信息。受益人编号不使用。) .类型:类型应为生意(公司）或收款人个人生意:要求提供企业详细信息，包括公司注册名称,地址与附加信息.收款人:要求提供企业详细信息，包括地址,附加信息.目的地:要求提供支付款的银行账户或银行卡信息。
全球支付 #
创建全球支付
直接提供受益人信息，创建新的全球赔款
公司要求
{
"受益人数据"：{
"类型"："business"、
"业务"：{
"company_registered_name"："XXX LTD"、
地址{
"line1"："3A座"、
"line2"："XX公园"、
"邮政编码"："98109",
"城市"："Seattle"、
"州"："WA"、
"country"："USA" （美国
},
"additional_info"：{
"business_registration_number"："32342353535334234MCA4",
"legal_rep_first_name"："明"、
"法律代表姓"："张"、
"legal_rep_id_type"："NATIONAL_ID"、
"legal_repid_number"（法律代表编号）： "233923874838920238x"："233923874838920238X",
"legal_rep_email"："xxx@email.com"、
"legal_rep_phone"："13727282938"
}
}
},
"amount"：666,
"currency"："cny"、
"描述"："您可以在此添加描述"、
"类型"："银行账户"、
"目的地数据"：{
"来源"：{
"account_holder_name"："xxxx ltd"、
"账户持有人类型"："公司"、
"银行名称"："美国银行"、
"国家"："USA"、
"货币"："美元"、
"account_number"："6210000000000002"
}
}
}回应
{
"id"："po_1654453881670729728",
"对象"："payout"、
"创建"：1683287519000,
"货币"："CNY"、
"金额"：666,
"描述"："您可以在此添加描述"、
"状态"："pending"、
"目的地"：{
"id"："ba_1654453883419754496",
"对象"："银行账户"、
"创建"：1683287519000,
"country"："USA"、
"货币"："美元"、
"指纹"："817902e3b6a2cf61eebc484f89467be650063413",
"last4"："0002",
"账户持有人姓名"："xxxx ltd"、
"account_holder_type"："公司"
},
"livemode": false、
"类型"："银行账户"、
"方法"："标准"、
"受益人{
"id"："bf_1654453881691701248",
"对象"："受益人"、
"类型"：业务"： "business
"业务"：{
"地址"：{
"city"："Seattle"、
"country"："USA"、
"line1"："3A街区"、
"line2"："XX公园"、
"州"："WA"、
"postal_code"："98109"
},
"公司注册名称"："XXX LTD"、
"additional_info"：{
"business_registration_number"："32342353535334234MCA4",
"legal_rep_first_name"："明"、
"法律代表姓"："张"、
"legal_rep_id_type"："NATIONAL_ID"、
"legal_repid_number"（法律代表编号）： "233923874838920238x"："233923874838920238X",
"legal_rep_email"："xxx@email.com"、
"legal_rep_phone"："13727282938"
}
}
}
}个人申请
通过直接提供受益人信息来创建付款单
{
"受益人数据"：{
"type"："payee"、
"收款人"： {
"地址"： {{
"line1"："### 大道"、
"line2"："#501"、
"邮政编码"98109",
"城市"："Seattle"、
"州"："WA"、
"country"："USA" （美国
},
"additional_info"：{
"last_name": "Kale"、
"first_name": "Leo"、
"id_type": "NATIONAL_ID"、
"id_country_iso_code": "USA"、
"id_number":"234242423423434X",
"电子邮件": "xxx@email.com"、
"电话": "1234534343"
}
}
},
"金额"：1000,
"currency"："USD"、
"描述"："您可以在此添加描述"、
"类型"："银行账户"、
"destination_data"：{
"来源"：{
"account_holder_name"："Leo Kale"、
"账户持有人类型"："个人"、
"银行名称"："美国银行"、
"国家"："USA"、
"货币"："美元"、
"account_number"："6210000000000002"
}
}
}回应
{
"id"："po_1654455721024028672",
"对象"："payout"、
"创建"：1683287958000,
"货币"："美元"、
"金额"：1000,
"description"："您可以在此添加描述"、
"状态"："pending"、
"目的地"：{
"id"："ba_1654455722777247744",
"对象"："bank_account"、
"创建"：1683287957000,
"country"："USA"、
"货币"："美元"、
"指纹"："3e27cccbe614f34d9b688b9eed46cea1cf9eee1d",
"last4"："0002",
"账户持有人姓名"："Leo Kale"、
"account_holder_type"："个人"
},
"livemode": false、
"类型"："银行账户"、
"方法"："标准"、
"受益人{
"id"："bf_1654455721040805888",
"对象"："受益人"、
"类型"："payee"、
"收款人"：{
"地址"：{
"city"："Seattle"、
"country"："USA"、
"line1"："### Ave"、
"line2"："#501"、
"州"："WA"、
"postal_code"："98109"
},
"additional_info"：{
"email"："xxx@email.com"、
电话"1234534343",
"姓名"："LeoKale"、
"姓"："Kale"、
"名"："Leo"、
"id_type"："NATIONAL_ID"、
"id_country_iso_code"："美国"、
"id_number"："234242423423434X"
}
}
}
}经常性付款
如果您已经向受益人支付过赔款，您可以使用 受益人编号, 目的地 保存在服务器上，您可以在最后一个响应中找到它。
在上述情况下、 受益人编号 是 "bf_1579357548861980672" 与 目的地 是 "ba_1654455722777247744"
要求
{
"受益人"："bf_1579357548861980672",
"金额"：888,
"currency"："USD"、
"描述"："您可以在此添加描述"、
"类型"："银行账户"、
"目的地"： "ba_1654455722777247744"ba_1654455722777247744"
}支付给中国 #
向中国创建新的付款
与全球支付不同的是，您需要提交 付款意向标识 在申请向中国付款时。
要求
{
"受益人"："bf_1579357548861980672",
"金额"：666,
"currency"："cny"、
"描述"："您可以在此添加描述"、
"类型"："银行账户"、
"目的地数据"：{
"来源"：{
"account_holder_name"："xxxx ltd"、
"账户持有人类型"："公司"、
"银行名称"："中国银行"、
"国家"："CN"、
"货币"："CNY"、
"account_number"："6210000000000002"
}
},
"payment_intents_id"：[
"pi_1577840204872417280"
]
}使用合规文件创建支付
如果您需要向我们提交合规文件，创建带合规文件的赔付有三个步骤
- 使用创建文件上传合规文件
要求
curl --location --request POST 'https://apitest.wooshpay.com/v1/files'\
--header 'Accept: application/json'\
--header 'Authorization：Your key' \
--header 'User-Agent：Apifox/1.0.0' \
--form'file=@"/路径/xxx.pdf"'回应
{
"id"："file_1654416327596572672",
"对象"："文件"、
"创建"：1683278565516,
"url"："https://oss.swooshtransfer.cn/oa/product/1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf"、
"类型"："pdf"、
"文件名"："1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf"
}- 复制 网址 关于 您的回复 在上述情况下
网址是https://oss.swooshtransfer.cn/oa/product/1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf - 申请
元数据对创建的赔付
元数据:它由两部分组成，第一部分是密钥第二部分是价值.- 例如
"元数据"：{ "compliance document"："您的文档网址", "key2"："value2", "..."："..." }
要求
{
{
"受益人"："bf_1579357548861980672",
"元数据"：{
"合规文件"："https://oss.swooshtransfer.cn/oa/product/1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf"
},
"金额"：666,
"currency"："cny"、
"描述"："您可以在此添加描述"、
"类型"："银行账户"、
"目的地数据"：{
"来源"：{
"account_holder_name"："xxxx ltd"、
"账户持有人类型"："公司"、
"银行名称"："中国银行"、
"国家"："CN"、
"货币"："CNY"、
"account_number"："6210000000000002"
}
},
"payment_intents_id"：[
"pi_1577840204872417280"
]
}
}已回复
{
"id"："po_1654421512435793920",
"对象"："payout"、
"创建"：1683279802000,
"货币"："CNY"、
"金额"：666,
"描述"："您可以在此添加描述"、
"元数据"：{
"合规文件"："https://oss.swooshtransfer.cn/oa/product/1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf"
},
"状态"："pending"、
"目的地"：{
"id"："ba_1654421514230956032",
"对象"："bank_account"、
"创建"：1683279801000,
"country"："CN"、
"货币"："CNY"、
"指纹"："4732b34681776e6b2383da452cbbabbcd2228d48",
"last4"："0002",
"账户持有人姓名"："xxxx ltd"、
"account_holder_type"："公司"
},
"livemode": false、
"类型"："银行账户"、
"方法"："标准"、
"受益人{
"id"："bf_1654421512456765440",
"对象"："受益人"、
"类型"：业务"： "business
"业务"：{
"地址"：{
"city"："Beijing"、
"国家"："CN"、
"line1"："3A 座
"线路 2"："XX 公园"、
"状态"："北京"、
"邮政编码"："323111"
},
"公司注册名称"："XXX 有限公司"、
"additional_info"：{
"business_registration_number"："32342353535334234MCA4",
"legal_rep_first_name"："明"、
"法律代表姓"："张"、
"legal_rep_id_type"："NATIONAL_ID"、
"legal_repid_number"（法律代表编号）： "233923874838920238x"："233923874838920238X",
"legal_rep_email"："xxx@email.com"、
"legal_rep_phone"："13727282938"
}
}
},
"payment_intents_id"：[
"pi_1577840204872417280"
]
}支付失败 #
如果银行账户因故无法收到付款，银行会将资金退回给我们。这将返回一个错误，并说明失败的原因。银行可能需要几个工作日才能退回赔款并通知我们失败。如果发生这种情况，您会在控制面板中收到通知。确保您提供的银行账户信息正确无误。如果不正确（例如账号有错别字），付款可能会发送到另一个银行账户持有人。
负支付 #
每笔赔付都反映了创建赔付时的可用账户余额。在某些情况下，您的账户余额可能为负数。例如，如果您收到 100 美元的付款，但退还了 200 美元的先前付款，您的账户余额将为-100 美元。如果您没有收到更多付款来平衡负数，新的付款将失败。
了解赔付结果 #
要知道向银行账户付款是否成功，需要设置一个 webhook。
向银行账户付款时，以下事件类型非常重要，您可以创建 webhook 来了解付款状态。
payout.canceled:每当取消支付时就会出现。payout.created:每当创建一个付款时都会出现。payout.failed:每当尝试赔付失败时就会出现。payout.paid:每当预计目标账户中会有一笔付款时就会发生。如果支付失败，稍后也会发送 payout.failed 通知。payout.updated:每当更新付款时发生。
确定要监控的事件后，您可以参考网络钩子指南，以 创建网络钩子.
即时支付 #
使用即时赔付功能，向支持的银行账户（在英国）发送资金可在一天内完成。您可以在任何时间（包括周末和节假日）申请即时支付，资金通常会出现在相关银行账户中。
| 国家/地区 | 支付速度(工作日） | 最低金额（当地货币） |
|---|---|---|
| 英国 | 0 | 0.01 英镑 |
