• 简体中文
  • POS 通知

    请求路径

    [POST] /api/pos/trans/notification

    参数列表

    名称类型长度必填描述
    transTypeInteger1Yes交易类型,当前类型为转账支付
    virtualAccountString10Yes银行分配给商家的虚拟NIP账户号码,用于收款
    virtualAccountNameString100No商家在NIP系统中由银行注册的名称
    terminalIdString5-10No收单行POS注册的TID
    sourceBankCodeString1-10Yes发送方银行/MMO NIP系统银行代码
    sourceBankNameString100Yes发送方银行/MMO账户号码,10位数字
    sourceAccountNoString10Yes发送方银行/MMO账户号码
    sourceAccountNameString100Yes发送方银行/MMO账户名称
    sessionIdString64Yes交易凭证会话ID,由渠道返回
    amountLong1-999999999Yes订单金额示例:100099(实际金额为NGN 1000.99)
    transactionReferenceString64Yes银行端交易参考号码
    transactionDateTimeDate-Yes交易日期时间示例 1671950880000
    transactionStatusInteger10Yes订单状态:1-成功,2-失败,3-待处理,4-关闭
    transactionMessageString10No交易结果描述:未支付,失败,完成等...
    narrationString200No发送方交易信息备注

    Return Values

    名称类型长度必填描述
    -Boolean-Yestrue 表示保存成功

    Postman 请求示例

    请求

    curl --location --request POST 'https://open-gw-sandbox.palmpay-inc.com/api/pos/trans/notification' \
    --header 'Accept: application/json, text/plain, */*' \
    --header 'CountryCode: NG' \
    --header 'Authorization: Bearer 26f3fa607c85b59aa1ad20dc34774a34' \
    --header 'Signature: oSCxDcjoNxgSFWy/Sh24ZtV1ms85yU07P4PKL3L4Ri1Bn6NI7LrgyOEVzS44zPJxQ8HLdpbH47ERCLOCbQpx66IDSQ8iSF/N5qpRaskRMzMrnirhnAb7Jli9Dq/4qCBqF7Of5l61vzkyTdRczS+c1OoQuTKDoVkLdJcpRnbrHdEbiZNy9BTmeE6c/WZI/+mllWR7dc6QK3R44HiCPY9UpHcQSkjngGYs4gyLXdIHEU9nRM+1isMmnckJL6jF+l120IS7eU3jgIV7bh06SE2hyL/V5yeX/L0Spw6H+DG0kPIY1v4BeDVXi23piPa9aiHgdXyWoF7WV71vEPI5f6LMCg==' \
    --header 'Content-Type: application/json' \
    --data '{
        "transType": 1,
        "virtualAccount": "8964239911",
        "virtualAccountName": "测试商户",
        "sourceBankCode": "000013",
        "sourceBankName": "测试银行",
        "sourceAccountNo": "100861008",
        "sourceAccountName": "测试账户名称",
        "sessionId": "test001",
        "amount": "10000",
        "transactionReference": "10131",
        "transactionDateTime": 1671950880000,
        "transactionStatus": 1,
        "transactionMessage": "测试消息",
        "narration": "qqqq",
        "requestTime": 1671950880000,
        "version": "V2.0",
        "nonceStr": "IBJGAeTa4ZJQv4Z2qufomVo9eI1YnJ9Y"
    }'

    响应

    {
      "respCode": "00000000",
      "respMsg": "success",
      "data": true
    }

    常见错误代码

    请参考文档

    业务错误代码

    错误代码错误描述解决方案
    PE无效参数检查请求参数,并在修正后重新发送
    PX重复交易检查交易参考号码,确认其唯一性