# 收款人创建结果查询

查询收款人状态

Endpoint: POST /api/v2/merch/beneficiary/inquiry
Version: 1.0.0

## Header parameters:

  - `X-Merch-Id` (string)

## Request fields (application/json):

  - `request_id` (string, required)
    请求号，请求方系统内唯一

  - `type` (string, required)
    目的(必填): PAYMENT-收款、WITHDRAWAL-提现

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (*/*):

  - `msg` (string)
    结果说明，失败时不为空

  - `payee_id` (string)
    收款人id, 仅创建成功并审核通过后返回；付款时可通过指定收款人 id 发起付款

  - `status` (string, required)
    付款人审核状态 PENDING-待审核 NORMAL-正常 REJECTED-审核未通过
    Enum: "PENDING", "NORMAL", "REJECTED"

## Response 400:

  - `400` (unknown)
    Bad Request

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 404:

  - `404` (unknown)
    Not Found

## Response 429:

  - `429` (unknown)
    Too Many Requests

## Response 500:

  - `500` (unknown)
    Internal Server Error