加纳支付接口

阅读该接口文档前，务必先查看接口说明。

限额

币种	代收	代付
GHS	10 - 100,000	10 - 100,000

代收API

代收授权可根据已启用渠道采用 OTP、STK Prompt 或重定向流程。

代收申请

简要描述：

创建代收订单

URL：/ghs/collect/apply 参数：

参数名	必填	类型	说明
appId	是	Integer	业务 ID，必须与 URL 币种匹配
orderId	是	String	商户唯一订单号，最多 48 个字符
amount	是	String	GHS 金额，最多 2 位小数
payType	是	String	`EWALLET`
inBankCode	否	String	`AIRTEL`、`MTN` 或 `VODAFONE`，以后台启用情况为准
name	否	String	付款人姓名
phone	是	String	12 位数字，以 `233` 开头且不带 `+`
email	否	String	有效的付款人邮箱
callBackUrl	是	String	支付成功跳转 URL
callBackFailUrl	是	String	支付失败跳转 URL
notifyUrl	否	String	异步通知 URL
subject	否	String	交易标题、商品名称或付款原因
body	否	String	详细备注
partnerUserId	否	String	唯一用户标识，最多 64 个允许字符
sign	是	String	签名

request

{
  "appId": 1054,
  "orderId": "GHSCOLLECT001",
  "amount": "100.00",
  "payType": "EWALLET",
  "inBankCode": "MTN",
  "phone": "233241234567",
  "callBackUrl": "https://merchant.example.com/success",
  "notifyUrl": "https://merchant.example.com/notify",
  "sign": "signature"
}

response

{
  "status": "1",
  "error": "",
  "msg": "success",
  "data": {
    "orderId": "GHSCOLLECT001",
    "orderNo": "6023071013539074",
    "amount": "100.00",
    "exchangeRate": "1",
    "orderAmount": "100.00",
    "payUrl": "https://payment.example.com/order/6023071013539074",
    "description": "Complete the Mobile Money authorization",
    "expiryPeriod": 15,
    "sign": "signature"
  }
}

返回data参数说明

参数名	类型	说明
orderId	String	商户订单号
orderNo	String	平台订单号
amount	String	交易金额
exchangeRate	String	汇率
orderAmount	String	订单金额
payUrl	String	支付地址
description	String	交易描述
expiryPeriod	Integer	支付有效期剩余分钟数
sign	String	签名

代收查询

简要描述：

查询代收订单

URL：/ghs/collect/query 参数：

参数名	必填	类型	说明
appId	是	Integer	业务 ID
orderId	是	String	商户订单号
orderNo	否	String	平台订单号
sign	是	String	签名

request

{
  "appId": 1054,
  "orderId": "GHSCOLLECT001",
  "orderNo": "6023071013539074",
  "sign": "signature"
}

response

{
  "status": "1",
  "error": "",
  "msg": "success",
  "data": {
    "orderId": "GHSCOLLECT001",
    "orderNo": "6023071013539074",
    "amount": "100.00",
    "actualAmount": "100.00",
    "fee": "1.00",
    "status": 2,
    "payTime": "2026-08-01 12:30:00",
    "errorMsg": "",
    "inBankCode": "MTN",
    "currency": "GHS",
    "originalCurrency": "GHS",
    "floatExchangeRate": "1",
    "originalAmount": "100.00",
    "certificateId": "",
    "sign": "signature"
  }
}

返回data参数说明

参数名	类型	说明
orderId	String	商户订单号
orderNo	String	平台订单号
amount	String	交易金额
actualAmount	String	实际收到金额
fee	String	手续费
status	Integer	订单状态
payTime	String	成功时间，当地时间，格式 `yyyy-MM-dd HH:mm:ss`
errorMsg	String	错误信息
inBankCode	String	收款银行编码
currency	String	币种
originalCurrency	String	原币种
floatExchangeRate	String	浮动汇率
originalAmount	String	原金额
certificateId	String	支付凭证 ID
sign	String	签名

支付方式

币种	支付类型（payType）	支付编码（inBankCode）	限额	状态	描述
GHS	EWALLET	AIRTEL	10 - 100,000	可用	AIRTEL
GHS	EWALLET	MTN	10 - 100,000	可用	MTN
GHS	EWALLET	VODAFONE	10 - 100,000	可用	VODAFONE

代付API

代付申请

简要描述：

创建代付订单

URL：/ghs/pay/apply 参数：

参数名	必填	类型	说明
appId	是	Integer	业务 ID，必须与 URL 币种匹配
orderId	是	String	商户唯一订单号，最多 48 个字符
amount	是	String	GHS 金额，最多 2 位小数
accountType	是	String	`EWALLET`
bankCode	是	String	`AIRTEL`、`MTN` 或 `VODAFONE`，以后台启用情况为准
accountNo	是	String	Mobile Money 账号：12 位数字，以 `233` 开头且不带 `+`
name	是	String	收款人姓名
phone	是	String	收款人手机号
email	否	String	有效的收款人邮箱
notifyUrl	否	String	异步通知 URL
subject	否	String	交易标题、商品名称或付款原因
body	否	String	详细备注
partnerUserId	否	String	唯一用户标识，最多 64 个允许字符
sign	是	String	签名

request

{
  "appId": 1054,
  "orderId": "GHSPAY001",
  "amount": "100.00",
  "accountType": "EWALLET",
  "bankCode": "MTN",
  "accountNo": "233241234567",
  "name": "John Doe",
  "phone": "233241234567",
  "notifyUrl": "https://merchant.example.com/notify",
  "sign": "signature"
}

response

{
  "status": "1",
  "error": "",
  "msg": "success",
  "data": {
    "orderId": "GHSPAY001",
    "orderNo": "3023062014149637",
    "payUrl": "",
    "sign": "signature"
  }
}

返回data参数说明

参数名	类型	说明
orderId	String	商户订单号
orderNo	String	平台订单号
payUrl	String	付款地址（如适用）
sign	String	签名

代付查询

简要描述：

查询代付订单

URL：/ghs/pay/query 参数： 请求字段与代收查询相同。

request

{
  "appId": 1054,
  "orderId": "GHSPAY001",
  "orderNo": "3023062014149637",
  "sign": "signature"
}

response

{
  "status": "1",
  "error": "",
  "msg": "success",
  "data": {
    "orderId": "GHSPAY001",
    "orderNo": "3023062014149637",
    "amount": "100.00",
    "fee": "1.00",
    "status": 2,
    "payTime": "2026-08-01 12:30:00",
    "errorMsg": "",
    "certificateId": "",
    "sign": "signature"
  }
}

返回data参数说明

参数名	类型	说明
orderId	String	商户订单号
orderNo	String	平台订单号
amount	String	交易金额
fee	String	手续费
status	Integer	订单状态
payTime	String	成功时间，当地时间，格式 `yyyy-MM-dd HH:mm:ss`
errorMsg	String	错误信息
certificateId	String	支付凭证 ID
sign	String	签名

支付方式

移动支付（EWALLET）

币种	支付类型（accountType）	支付编码（bankCode）	限额	状态	描述
GHS	EWALLET	AIRTEL	10 - 100,000	可用	AIRTEL
GHS	EWALLET	MTN	10 - 100,000	可用	MTN
GHS	EWALLET	VODAFONE	10 - 100,000	可用	VODAFONE

快速开始

商户指南

公共支付

全球支付

统一支付

测试与上线

附录

商户QA

加纳支付接口

限额

代收API

代收申请

代收查询

支付方式

代付API

代付申请

代付查询

支付方式

相关主题

​限额

​代收API

​代收申请

​代收查询

​支付方式

​代付API

​代付申请

​代付查询

​支付方式

​相关主题

限额

代收API

代收申请

代收查询

支付方式

代付API

代付申请

代付查询

支付方式

相关主题