沙箱测试中转账到支付宝应使用什么收款账号?
支付小周
结论
在沙箱环境中测试“转账到支付宝”时,收款账号应填写支付宝开放平台控制台中的沙箱买家账号,不能使用真实支付宝账号。
进入应用的沙箱配置页面,在“沙箱账号”中找到买家账号,将其登录账号填为收款方。该账号通常由平台自动生成,格式可能是邮箱或手机号,具体以控制台显示的信息为准。
为什么不能使用真实支付宝账号
沙箱环境和支付宝正式环境彼此隔离:
- 沙箱中的资金是虚拟资金,不会发生真实资金流转。
- 真实支付宝账号通常不能作为沙箱交易的收款方。
- 沙箱卖家账号代表当前测试商户。模拟向个人支付宝账号转账时,一般使用沙箱买家账号收款。
- 沙箱与正式环境的网关地址、应用凭证和账号体系不能混用。
操作步骤
- 登录支付宝开放平台控制台。
- 进入需要测试的应用。
- 打开“沙箱环境”或“沙箱应用”页面。
- 在“沙箱账号”中找到平台分配的买家账号。
- 确认买家账号状态正常,并按照控制台提示,使用沙箱版支付宝完成必要的登录或实名认证模拟。
- 调用转账接口时,将该沙箱买家账号填入收款账号字段。
- 将请求发送到沙箱网关,并使用沙箱应用的
app_id、应用私钥和支付宝沙箱公钥。
常见的沙箱网关地址是:
https://openapi-sandbox.dl.alipaydev.com/gateway.do
实际地址以当前控制台及所用 SDK 的配置说明为准。
请求示例
不同转账接口使用的字段名称可能不同。下面的示例只说明收款账号应填写在哪个位置,其他参数请以实际调用接口的文档为准:
{
"out_biz_no": "TRANSFER_202609090001",
"payee_type": "ALIPAY_LOGONID",
"payee_account": "控制台中显示的沙箱买家登录账号",
"amount": "0.10",
"remark": "沙箱转账测试"
}
如果接口通过参与方结构接收收款人信息,请求形式可能如下:
{
"out_biz_no": "TRANSFER_202609090001",
"trans_amount": "0.10",
"product_code": "TRANS_ACCOUNT_NO_PWD",
"biz_scene": "DIRECT_TRANSFER",
"payee_info": {
"identity": "控制台中显示的沙箱买家登录账号",
"identity_type": "ALIPAY_LOGON_ID"
},
"order_title": "沙箱转账测试"
}
这些字段仅用于说明收款账号的位置,不能用来判断当前应用应该调用哪个转账 API。新旧转账产品的接口名称、字段和权限要求可能不同。
注意事项
- 不要使用真实的支付宝手机号、邮箱或用户 ID 测试沙箱收款。
- 不要将沙箱卖家账号填为收款人。卖家账号通常代表测试商户。
- 收款账号必须与账号类型匹配。如果填写的是登录名,应使用
ALIPAY_LOGONID,或接口文档规定的对应枚举值。 - 如果接口要求填写支付宝用户 ID,而非登录账号,应使用控制台或沙箱客户端能够获取的沙箱用户标识,不能用登录账号代替。
- 沙箱买家余额不足通常会影响付款测试,但作为转账收款方时,账号仍需处于有效状态。
- 遇到“收款账号不存在”“买卖家账号不能相同”或“无接口权限”等错误时,可依次检查沙箱账号、账号类型、网关地址、应用凭证和产品签约状态。
- 上线后必须改用正式网关和正式应用配置,并填写真实收款账号。沙箱账号不能用于生产环境。
备注:内容仅供参考。
