简体中文

English

简体中文

English

显示模式

关于 交易 ​

访问范围

需要多个访问范围—请参阅每个端点以了解访问范围要求。

需要访问受保护的客户数据。

支付是 Genstore 交易处理的核心组成部分，它提供了完整的支付和退款信息查询能力。通过该模块，商家可以查询支付单和退款单的处理状态、通道外部单号、支付成功时间等相关信息，实现交易流程的精准跟踪。

核心概念

  • 支付单：记录支付交易的凭证，包含支付状态、支付时间及支付平台生成的交易流水号等信息。
  • 退款单：记录退款交易的凭证，包含退款状态、退款时间及支付平台生成的退款流水号等信息。
  • 单号体系：
    • 内部交易单号：Genstore 系统生成的支付和退款标识符。
    • 平台交易单号：外部支付平台（如支付宝、微信支付）生成的交易凭证号。
    • 订单/退款单号：商家业务系统提供的订单或退款编号。

核心功能

  • 查询支付单：获取支付单详情，支持通过内部支付单号查询，包括支付单状态、通道外部单号、支付成功时间等信息。
  • 查询退款单：获取退款单详情，支持通过内部退款单号查询，包括支付单状态、通道外部单号、支付成功时间等信息。

业务场景

  • 支付状态跟踪：商家可实时查询支付单状态，及时确认交易完成情况。
  • 退款进度监控：运营团队可查询退款单处理进度，保障退款及时到账。
  • 交易记录核对：财务人员可通过外部单号，与支付通道进行交易核对。

接口

GET /api/202412/payment/{paymentId}: 获取支付单信息

支付交易 对象 ​

一个支付交易对象。

属性 ​

paymentobject
- 收起属性
channelTrxNostring
外部通道的单号。
paymentIdstring
支付单号，全局唯一。
outOrderNostring
交易对应的订单号。
successPaymentTimestring
支付成功时间，格式 YYYY-MM-DDThh:mm:ssTZD ISO-8601。
statusstring
支付状态。1-处理中，2-已支付，3-预授权取消，4-预授权成功，9-支付失败。
currencystring
交易的币种。
amountnumber
交易的总金额。
feenumber
交易的手续费。
netnumber
交易的净额。
bash
{
  "payment": {
    "successPaymentTime": "2019-06-28T18:03:50+01:00",
    "amount": "123.23",
    "channelTrxNo": "0SX593062F1597043",
    "paymentId": "PI0020241010151755224",
    "fee": "5.01",
    "currency": "USD",
    "net": "118.22",
    "outOrderNo": "101010101000000000136",
    "status": "1"
  }
}

GET 获取支付单信息 ​

查询支付单信息。

访问范围

需要以下任意访问权限: write_payments_transaction read_payments_transaction

接口

GET /api/202412/payment/{paymentId} 

请求参数

paymentIdstring
支付单号，全局唯一。

响应数据

paymentobject
支付信息。
- 收起属性
channelTrxNostring
外部通道的单号。
paymentIdstring
支付单号，全局唯一。
outOrderNostring
交易对应的订单号。
successPaymentTimestring
支付成功时间，格式 YYYY-MM-DDThh:mm:ssTZD ISO-8601。
statusstring
支付状态。1-处理中，2-已支付，3-预授权取消，4-预授权成功，9-支付失败。
currencystring
交易的币种。
amountnumber
交易的总金额。
feenumber
交易的手续费。
netnumber
交易的净额。
bash
curl -X GET \ 
https://{shop}.genmystore.com/api/202412/payment/{paymentId}" \ 
-H "X-Genstore-Access-Token: {access_token}" \
json
HTTP/1.1 200 OK
{
  "payment": {
    "successPaymentTime": "2019-06-28T18:03:50+01:00",
    "amount": "123.23",
    "channelTrxNo": "0SX593062F1597043",
    "paymentId": "PI0020241010151755224",
    "fee": "5.01",
    "currency": "USD",
    "net": "118.22",
    "outOrderNo": "101010101000000000136",
    "status": "1"
  }
}