# 付款结果通知

付款结果通知

Endpoint: POST /api/v2/merch/pay/notify
Version: 1.0.0

## Header parameters:

  - `X-Merch-Id` (string)

## Request fields (application/json):

  - `type` (string, required)

  - `version` (string, required)
    版本号(V1、V2、...)

  - `data` (object, required)

  - `data.request_id` (string, required)

  - `data.status` (string, required)
    状态
    Enum: "PROCESSING", "SUCCEEDED", "FAILED", "RETURNED"

  - `data.fee_amount` (integer, required)
    手续费(币种为付款货币，该币种最小单位)

  - `data.beneficiary_type` (string, required)
    收款人类型
    Enum: "PAY", "WITHDRAW"

  - `data.merch_id` (string, required)
    商户id

  - `data.order_no` (string, required)
    付款订单号

  - `data.product_type` (string, required)
    产品类型 B2B-B2B外贸 B2C-跨境电商

  - `data.failed_reason` (string, required)
    失败原因

  - `data.payment_currency` (string, required)
    付款原币种

  - `data.received_currency` (string, required)
    付款目标币种

  - `data.payment_amount` (string, required)
    付款金额

  - `data.received_amount` (string, required)
    到账金额

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/octet-stream):

  - `status` (string, required)
    状态
    Enum: "PROCESSING", "SUCCEEDED", "FAILED"

  - `fee_amount` (integer, required)
    手续费(币种为付款货币)

  - `beneficiary_type` (string, required)
    收款人类型
    Enum: "PAY", "WITHDRAW"

## 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

