注册状态查询

POST /v1/merchants/inquiryRegistrationStatus

使用此接口并发送二级商户的信息或商户注册请求 ID 来查询二级商户的注册状态。

结构

报文由报文头和报文体组成。本文主要介绍报文体结构信息,有关报文头的结构信息,请参阅:

注意:将每个字段(除数组外)的数据类型设置为字符串。这意味字段值必须使用双引号(" ")括起来。例如:

  • 如果字段的数据类型为整数属性,且其值为 20,设置为 "20"。
  • 如果字段的数据类型为布尔属性,且其值为 true,设置为 "true"。

入参

referenceMerchantId String  

由收单机构分配的二级商户 ID。

更多信息:

  • 最大长度:64 字符

registrationRequestId String  

用于识别注册请求的专属 ID。

更多信息:

  • 最大长度:64 字符

referenceStoreId String  

收单机构为识别与商户关联的商店而分配的商铺 ID。

更多信息:

  • 最大长度:32 字符

出参

result Result  REQUIRED

请求结果包含状态和错误代码等信息。

Show child parameters

registrationResult RegistrationResult  

支付方式注册结果信息。

Show child parameters

pspRegistrationResultList Array<PSPRegistrationResult>  

Alipay+支付方式的注册结果。

Show child parameters
API Explorer

请求

URL
请求体

响应

响应体

更多信息

请参阅以下列表,了解主要参数的重要细节:

  • 虽然 registrationRequestIdreferenceMerchantId referenceStoreId 都是可选的,但我们建议包含 referenceMerchantId referenceStoreId
  • 如果初次注册时信息报告有误,允许对同一二级商户进行重新注册。当请求包含 requestId 时,将返回注册结果。如果没有 requestId,但请求中包含 referenceMerchantId,则返回当前二级商户所有支付方式的状态。

不同情况的响应

本节提供了查询注册状态不同情况下的响应。

PARAM_ILLEGAL
RECORD_NOT_FOUND
钱包端待处理
已拒绝

返回的支付方式状态为APPROVED,注册状态为COMPLETED

Sample Code

返回的电子钱包状态为空,注册状态为COMPLETED

Sample Code

结果码

结果码结果码信息行动建议
SUCCESSS成功

注册成功,无需进一步操作。

INVALID_CLIENTF客户端无效。

请检查 clientId 是否正确。

MEDIA_TYPE_NOT_ACCEPTABLEF服务器不支持客户端可接受的媒体类型。

请检查媒体类型是否正确。

METHOD_NOT_SUPPORTEDF服务器不支持请求的 HTTP 方法。

请检查 HTTP 方法是否正确。

REPEAT_REQ_INCONSISTENTF重复请求不一致。

更改 registrationRequestId,然后再次调用接口。

RECORD_NOT_FOUNDF系统无法找到给定的 referenceMerchantId 和/或 referenceStoreId 的注册记录。

找不到注册记录。请检查 referenceMerchantId referenceStoreId 是否正确。