跳到主要内容

话费充值接口

接口说明

给指定手机号充值话费

接口地址

https://api.paynicorn.com/trade/topup/api/topup

请求方式:post

请求参数

参数名参数类型填写要求描述
appKeystringM商户应用Appkey
transIdstringM商户交易号
countryCodestringM国家码
bizTypestringM业务类型 说明:固定是m_topup 话费
operatorCodestringM运营商编码(根据手机号查询运营商接口获取)
benefitNostringM要充值的号码(不需要国家码)
amountBigDecimalM充值金额(支持的金额以paynicorn 运营提供为准)
memostringO备注
currencystringO充值币种(默认本币)

响应参数

参数名参数类型填写要求备注
codeintM请求处理的标识
msgstringM请求处理信息
resultJsonObjO返回结果

result对象参数

参数名参数类型填写要求描述
transIdstringM交易ID
statusCodestringM交易状态
descriptionstringM描述

示例

Request

{
"appKey": "p3k0Y312LzX6Dv87lVa1",
"transId": "123456789",
"countryCode": "NG",
"bizType": "m_topup",
"operatorCode": "9mobile",
"benefitNo": "08184123954",
"amount": 100,
"memo": "话费充值",
"currency": "USD"
}

Response

{
"code": 1200,
"msg": "success",
"result": {
"transId": "123456789",
"statusCode": "0",
"description": "transaction in processing"
}
}