SA-starpago-zh
  1. 代付
SA-starpago-zh
  • 接入指引
  • 附件码表
  • 签名示例
  • 签名常见问题解决方案
  • 印尼 - 银行编码对照表
  • 泰国 - 银行编码对照表
  • 巴基斯坦 - 银行编码对照表
  • 孟加拉 - 银行编码对照表
  • 菲律宾 - 银行编码对照表
  • 代收
    • 巴基斯坦-代收订单创建
      POST
    • 泰国-代收订单创建
      POST
    • 菲律宾-代收订单创建
      POST
    • 孟加拉-代收订单创建
      POST
    • 代收订单查询
      GET
  • 代付
    • 巴基斯坦-代付订单创建
      POST
    • 泰国-代付订单创建
      POST
    • 菲律宾-代付订单创建
      POST
    • 孟加拉-代付订单创建
      POST
    • 代付订单查询
      GET
  • 账户
    • 余额查询
      GET
  • 回调通知
    • 代收回调通知
    • 代付回调通知
  1. 代付

代付订单查询

GET
{{HOST}}/api/v2/payout/order/query

特别声明#

代付订单创建发起时,若 HTTP 响应状态码非 200 的情况,一定要通过商户管理后台或者订单查询接口二次核验订单状态,若订单存在且状态为"生成订单"和“交易异常”,则当前订单暂处于进行中状态,不要进行任何订单变更行为,否则将有可能发生不必要的资损,因此请谨慎操作。如果是创建接口返回业务 code 为 400 且有明确的参数验证失败的情况,可以无需查询,直接判定订单失败。若有任何疑问请第一时间向 Starpago 团队确认,查询接口一定要以订单状态(orderStatus)为订单判断依据,若是其他任何异常情况,请不要私自修改订单状态,需要向 Starpago 团队人工参与进行后续确认,请不要对订单中的提现信息进行二次提现操作,以避免不必要的资金损失。

Request

Query Params
appId
string 
required
应用号
Example:
a0c07e56c281c23c9b0bfd94923cfb9d
merOrderNo
string 
optional
商户订单号(orderNo二选一)
Example:
20220408123109677
orderNo
string 
optional
交易订单号(merOrderNo二选一)
sign
string 
required
签名
Example:
a8e8789b76d43d57d3b72fdfb14f482761e05a192a86048b90710f517369f5f8

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET '{{HOST}}/api/v2/payout/order/query?appId=a0c07e56c281c23c9b0bfd94923cfb9d&merOrderNo=20220408123109677&orderNo&sign=a8e8789b76d43d57d3b72fdfb14f482761e05a192a86048b90710f517369f5f8'

Responses

🟢200成功
application/json
Body
code
integer 
响应状态码
required
data
object 
返回数据
required
orderStatus
integer 
订单状态
required
支付中 0 1 -4
支付成功 2 3
支付失败 -1 -2 -3
orderNo
string 
交易订单号
required
merOrderNo
string 
商户订单号
required
amount
number 
订单金额
required
currency
string 
金额币种
required
receiptUrl
string 
凭证信息
optional
动态数据,视订单情况存在
createTime
integer 
required
updateTime
integer 
required
message
string 
描述信息
required
订单异常时会返回此字段,用作异常描述
sign
string 
签名
required
msg
string 
返回文字描述
required
Example
{
    "code": 0,
    "data": {
        "orderStatus": 1,
        "orderNo": "202204191703308526031",
        "merOrderNo": "202204191703302152",
        "amount": 10,
        "currency": "CNY",
        "attach": null,
        "createTime": 1650359010851,
        "updateTime": 1650359011745,
        "sign": "2293b6e8089bb8f65811503ae05e181be450412c9a6ce1bdd285816866363bb7"
    },
    "msg": "请求成功"
}
Modified at 2025-01-02 07:49:59
Previous
孟加拉-代付订单创建
Next
余额查询
Built with