商户接口文档
  1. 接口说明/Intro
商户接口文档
  • 接口说明/Intro
    • 接口加解密说明/encryption
  • 账户接口
    • 账户余额/Account balance
      POST
  • VCC接口
    • 场景列表查询/scene query
      POST
    • 卡头查询/ Card bin query
      POST
    • 开卡申请/ card apply
      POST
    • 销卡申请/Cancel card
      POST
    • 充值/card topup
      POST
    • 卡片查询/card query
      POST
    • 卡片分页查询/card query(list)
      POST
    • 交易查询/transaction query
      POST
    • 卡转出/card refund
      POST
    • 共享卡开卡申请/ shared card apply
      POST
    • 共享卡分页查询/shared card query(list)
      POST
    • 共享卡查询/shared card query
      POST
    • 共享卡状态变更/modify shared card status
      POST
    • 卡片信息修改/edit card info
      POST
    • 持卡人申请/card holder apply
      POST
    • 持卡人详情查询/card holder query
      POST
    • 持卡人删除/delet card holder
      POST
    • 卡片操作订单查询/ transaction query
      POST
  • Webhook通知
    • Webhook通知
    • 交易结果通知 type = card_transaction
    • 订单结果通知 type = card_operate
    • 3ds 通知 type = card_3ds_otp
  • 附录
    • 交易类型/ transaction types
    • 交易响应码/ respond code
    • 币种/Currency
    • 手机前缀/phone prefix
    • 美国州二字码/ USA states code
    • 国家代码/Country code
  • 数据模型
    • card bin
    • 卡片信息
    • 账单信息
    • 持卡人信息
    • 授权交易记录
    • 附属卡信息
    • 卡 bin
    • 卡片订单记录
  1. 接口说明/Intro

接口加解密说明/encryption

一、接口请求:#

接口参数
序号域名变量名必填字段类型备注
1版本号versionMString(6)1.0.0
2商户号userNoMString(19)提供给商户的唯一编号/Unique image.png
3数据类型dataTypeMString(8)JSON
4加密数据dataContentMString(2048)具体参数如下加密数据
1.
将 dataContent 转换成 json 字符串
2.
对 json 字符串进行 base64 编码
3.
使用 rsa 1024 对 base64 编码进行非对称加密成 byte 数组
4.
将 byte 数组转换成 16 进制字符串
En:
1.
Convert dataContent to a JSON string.
2.
Base64-encode the JSON string.
3.
Asymmetrically encrypt the Base64-encoded string using RSA 1024 to convert it into a byte array.
4.
Convert the byte array into a hexadecimal string.
测试环境:https://uat-openapi.geo.sh.cn/
生产环境:https://openapi.geo.sh.cn/

二、接口返回:#

序号域名变量名必填字段类型备注
1成功标识successMboolean返回 true(成功)、false
2错误码errorCodeOnumbersuccess 为 false,errorCode 有值,详见错误码描述
3错误描述errorMsgOString(256)错误描述,success 为 fasle 时不为空
4返回结果信息resultOString(1024)SUCCESS 为 false 时为空,其他时候不为空
5商户编号userNoMString(11)提供给商户的唯一编号
6是否异步asyncMbooleanTrue 表示业务处理中,会回调通知结果,false 表示同步处理,result
1、返回的数据格式同商户的JSON,商户先用公钥解密后,再解 base64,即可得到
修改于 2025-09-25 09:37:41
下一页
账户余额/Account balance
Built with