全球账户
Business Account Resource
Business Account Object
Example BusinessAccount Object
{
"id": "3732c2ee-ebb5-466a-9acf-5bc76986b140",
"accountId": "418b0432-b092-425c-a061-f2486c8efe5c",
"createTime": "1754547327312",
"nickname": "InstaPay Wallet",
"purpose": "",
"currency": "USD",
"balanceId": "d72e292f-c762-4d2b-b20a-1157cf818f98",
"bankAccounts": [
{
"status": "ACTIVE",
"currency": "USD",
"accountNo": "GB49TCCL12345614818413",
"accountId": "d37deed7-f0e7-4635-a43a-781af0cb59f0",
"createTime": "1754475956",
"bankName": "The Currency Cloud Limited",
"routingType": "BIC_SWIFT",
"routingNumber": "TCCLGB3L",
"bankAddress": {
"addressLine1": "123 Main St",
"addressLine2": "Apt 4B",
"city": "New York",
"state": "NY",
"postalCode": "10001",
"country": "US"
},
"accountName": "API TEST"
}
]
}Business Account Attributes
id string
BusinessAccount 的 UUID。
accountId string
Account 的 UUID。
createTime string
时间戳。
nickname string
昵称
currency string
币种
purpose string
用途
balanceId string
余额 ID
bankAccounts array of objects
BankAccounts 详情
Object
Example BankAccount Object
{
"status": "ACTIVE",
"currency": "USD",
"accountNo": "GB49TCCL12345614818413",
"accountId": "d37deed7-f0e7-4635-a43a-781af0cb59f0",
"createTime": "1754475956",
"bankName": "The Currency Cloud Limited",
"routingType": "BIC_SWIFT",
"routingNumber": "TCCLGB3L",
"bankAddress": "12 Steward Street, The Steward Building, London, E1 6FQ, GB",
"accountName": "API TEST"
}BankAccount Attributes
accountId string
Account 的 UUID。
accountName string
账户持有人名称
accountNo string
账户号码
currency string
币种
bankName string
银行名称
bankAddress string
银行地址
swift string
SWIFT/BIC 代码
routingNumber string
路由号码
routingType string
路由类型
branchName string
分行名称
branchCode string
分行代码
status string
BankAccount 对象的状态。可选值：ACTIVE（激活）、FROZEN（冻结）、INACTIVE（未激活）。
createTime string
时间戳。
Business Account Transactions Object
Example BusinessAccountTransactions Object
{
"id": "09469112-d119-4003-b1f9-954b06458690",
"accountId": "c110126c-cbb2-4306-8977-37c88fb4a47a",
"currency": "USD",
"counterparty": "US-USD-3525-Swift",
"settlementAmount": "200.00",
"transactionDisplayId": "2507101727000005",
"fees": [
{
"amount": "25.00",
"currency": "USD",
"feeType": 0
}
],
"businessType": "OUTBOUND",
"status": "PENDING",
"reference": "test",
"originTransferId": "4c7fd05e-b273-4427-8b1c-2d2c7fc2a836",
"clientTransactionId": "22fc8ee2-5afe-4586-b733-17b97ccc870f"
}Business Account Transactions Attributes
id string
记录的 UUID。
accountId string
Account 的 UUID。
currency string
交易币种（例如 “USD”）。
counterparty string
结算中的交易对手标识或显示名称。
settlementAmount string
结算总金额。
transactionDisplayId string
交易的外部展示 ID。
fees array
交易相关的费用列表。
businessType string
业务类型。
OUTBOUND：出账（例如付款、转出）。
INBOUND：入账（例如入金、转入）。
status string
交易状态。
PENDING：处理中。
REFUNDING：退款中。
CLOSED：已关闭。
CANCELLED：已取消。
REJECTED：已拒绝。
REQUESTED：已发起但未处理。
UNKNOWN：未知状态。
PAYMENT_FAILED：支付失败。
USER_CANCELLED：用户取消。
INBOUND_RELATIONSHIP_CONFIRM：资料已通过，入账关系已确认。
INBOUND_RELATIONSHIP_CONFIRM_REQUEST：需要补充或资料被拒。
reference string
外部或内部备注。
originTransferId string
原始交易 ID。
clientTransactionId string
客户端提供的交易 ID。
Legal Entity Object
Example Legal Entity Object
{
"accountId": "123e4567-e89b-12d3-a456-426614174000",
"accountName": "My Business Account",
"id": "123e4567-e89b-12d3-a456-426614174000",
"message": "Legal entity created successfully",
"status": "PENDING"
}Legal Entity Attributes
id string
记录的 UUID。
accountId string
Account 的 UUID。
accountName string
账户名称。
message string
主体信息提示。
status string
PENDING：已提交，等待处理。
PROCESSING：审核中。
AWAIT_ADDITIONAL：需要补充信息。
REVIEW_ADDITIONAL：补充信息审核中。
REQUEST：已请求操作。
FROZEN：已冻结。
FAILED：失败。
DELETED：已删除。
INACTIVE：未激活。
ACTIVE：已激活。
Fee Objects
Example
{
"amount": 2,
"currency": "USD",
"feeType": 0
}Attributes
amount string
金额（按币种单位）。
currency string
币种代码。
feeType integer
手续费类型。
0：平台收取的手续费。
Updated 5 days ago