create a sub accountV2

创建一个子账户

为商家创建一个子账户

HTTP请求

POST /v1/mx/payments/charges/spei/create

请求响应

Request Headers

{
    "Content-Type": "application/json",
    "Authorization": "Bearer {{access_token}}",
    "x-api-key": "{{api_key}}"
}

Request Body

{
    "idempotencyKey": "9009f382-addc-11eb-8529-0242ac130003",
    "friendlyName": "{{TARGET_ACCOUNT_FRIENDLY_NAME}}",
    "legalName": "{{TARGET_ACCOUNT_LEGAL_NAME}}",
    "phoneNumber": "{{TARGET_ACCOUNT_PHONE_NUMBER}}"
}

Content-Type: application/json

{
    "statusCode": 200,
    "errorMsg": "",
    "idempotencyKey": "9009f382-addc-11eb-8529-0242ac130003",
    "accountUuid":"{{CREATED_SUB_ACCOUNT_UUID}}",
    "accountId":"{{CREATED_SUB_ACCOUNT_CLABE_NUMBER}}",
    "friendlyName":"{{TARGET_ACCOUNT_FRIENDLY_NAME}}",
    "legalName":"{{TARGET_ACCOUNT_LEGAL_NAME}}",
    "phoneNumber":"{{TARGET_ACCOUNT_PHONE_NUMBER}}"
}

HTTP Headers 字段说明

Key	Value
Content-Type	application/json
Accept	application/json
Authorization	"Bearer" + " " + {{access_token}}
x-api-key	{{api_key}}

路径参数

参数	是否必填	类型	描述
idempotencyKey		String	此参数用于幂等目的，请求的唯一标识ID 长度不大于128个字节。
friendlyName		String	用户的友好名称（用于显示）.
legalName		String	用户的正式合法名称。
phoneNumber		String	与此子账号关联的手机号码.

Response Body 字段说明

参数	类型	描述
statusCode	Integer	状态代码，200 代表成功2, 401 访问受限, 422 参数错误, 500 内部错误
errorMsg	String	如果交易失败，返回的错误信息
idempotencyKey	String	子账号创建时请求的唯一标识ID
accountUuid	UUID	创建的子账号的UUID
accountId	String	创建的子账号墨西哥的CLABE号码.
friendlyName	String	用户的友好名称（用于显示）.
legalName	String	用户的正式合法名称.
phoneNumber	String	与此子账号关联的手机号码.未填写时不返回该参数