概述

账户标识是系统为账户分配的唯一标识，用于标识不同账户主体对应的资金池，其中account_id字段表示该账户标识。

创建子账户

注意

如需使用父子账户体系，请先联系Oceanpayment运营经理进行申请。经审核并开通相关权限后，即可创建和管理子账户，并在创建卡片时可指定卡片归属的主账户或子账户。

Request

用父级别账户{account_id}来创建子账户：

cURL -X POST /v1/account/{account_id}
-H 'Content-Type: application/json'
-H 'Authorization: {token}'
-d '{
	"program_value": 2,
	"primary_person": {
	    "first_name": "Joe",
	    "last_name": "Bauer",
	    "middle_name": "Joe",
	    "last_name2": "Bauer",
	    "dob": "19820301",
	    "nick_name": "Chuck",
	    "title": "Dr",
	    "suffix": "Jr"
	},
	"addresses": [{
            "line1": "123 Main St.",
            "postal_code": "12345",
            "type": "home",
            "line2": "123 Main St.",
            "line3": "123 Main St.",
            "neighborhood": "Sunfield",
            "city": "Austin",
            "state": "TX",
            "country": "US"
	}],
	"phones": [{
            "type": "contact",
            "country_code": "USA",
            "phone_number": "178549645256"
	}],
	"emails": [{
            "type": "personal",
            "email": "user@example.com",
            "state": "verified"
	}]
  }

参数名	类型	长度	是否必填	描述	示例
program_value	int	1-10	是	program账户卡类型	2
+primary_person	object	-	是	主要持卡人信息	{ "primary_person":[{ "first_name":"firstname", "last_name":"lastname", }] }
+addresses	object	-	否	地址列表	{ "addresses":[{ "line1":"contact", "postal_code":"518000", "type":"home", "country":"USA" }] }
+phones	object	-	否	电话列表	{ "phones":[{ "type":"contact", "country_code":"+86", "phone_number":"178549645256" }] }
+emails	object	-	否	邮箱列表	{ "emails":[{ "type":"personal", "email":"user@example.com", "state":"verified" }] }

Response

{
    "code": "200",
    "msg": "操作成功",
    "data": {
        "account_id": "1016X10007530070724",
        "parent_account_id": "1016X10007422220312",
        "creation_time": 1782367203137,
        "modified_time": 1782367203137
    }
}

参数名	类型	描述	示例
account_id	string	子商户账户唯一标识号	1016X10007530070724
parent_account_id	string	父商户账户唯一标识号	1016X10007422220312
creation_time	long	创建时间（Unix时间戳，毫秒）	1782367203137
modified_time	long	修改时间（Unix时间戳，毫秒）	1782367203137

查询账户

商户可以根据Program查询当前账户号下的所有account_id（包含父子账户），即当前商户在当前Program下的所有Customer Number。

Request

cURL -X POST /v1/account/list
-H 'Content-Type: application/json'
-H 'Authorization: {token}'
-d '{
    	"program_value": 2,
        "limit": 1,
        "cursor": ""
    }

参数名	类型	长度	是否必填	描述	示例
program_value	int	1-10	是	账户卡类型	2
limit	long	0-100	否	每页返回条数，最大100条	1
cursor	string	0-10	否	上一页返回的next_cursor，首次不传	1

Response

{
    "code": "200",
    "msg": "操作成功",
    "trace_id": "bb760ffd429f4e1f90be56c5bb876ebe",
    "data": {
        "next_cursor": null,
        "has_more": false,
        "account_id": "1016X10035353230174",
        "child_accounts": [
            {
                "child_account_id": "1016X10035972320620"
            },
            {
                "child_account_id": "1016X10035972290385"
            }
        ]
    }
}

参数名	类型	长度	是否必填	描述	示例
next_cursor	string	-	-	下一页游标，has_more为false时为null	1
has_more	boolean	-	-	是否有下一页 ture false	1
account_id	string	-	-	父账户ID	1016X10035353230174
+child_accounts	object	-	-	-	-