• 简体中文
  • 创建订单

    请求路径

    /api/v2/payment/merchant/createorder

    参数列表

    名称类型长度必填描述
    orderIdString32是商户唯一订单号,可用于查询交易结果
    titleString100否订单标题
    descriptionString200否订单描述
    amountLong-是交易金额(精确到分,如“100”代表1 ZAR) 最小金额:100
    currencyString10是货币代码(ZAR)
    notifyUrlString200是接收交易结果通知url
    callBackUrlString200是支付完成后H5页面返回商户指定url地址
    goodsDetailsString-是/否JSONArray string格式,详见:商品详情列表;国际客户必填
    remarkString200否备注信息
    productTypeString100是固定传instant_eft

    返回值

    名称类型长度必填描述
    orderNoString32是PalmPay平台订单号
    orderStatusInteger20是订单状态(见订单状态)
    messageString50否状态描述信息
    checkoutUrlString200是拉起H5支付的url
    currencyString10是货币代码(NGN、GHS、TZS、KES、ZAR)
    orderAmountLong-是交易金额(最小单位计量)

    错误码

    参见此文

    Postman请求示例

    request

    curl--location'https://open-gw-sandbox.palmpay-inc.com/api/v2/payment/merchant/createorder' \
            --header'Accept: application/json, text/plain, */*' \
            --header'CountryCode: ZA' \
            --header'Authorization: Bearer 10241024' \
            --header'Signature: D11A3E8CB478C0B0F40276DDA5AFD898' \
            --header'Content-Type: application/json' \
            --data'{
            "productType": "instant_eft",
            "requestTime": 1761209294351,
            "version": "V1.1",
            "nonceStr": "IBJGAeTa4ZJQv4Z2qufomVo9eI1YnJ9Y",
            "amount": 35000,
            "notifyUrl": "https://xx.cn/callback/payment",
            "orderId": "merchantOrderId",
            "currency": "ZAR",
            "callBackUrl": "http://callBackUrl.com",
            "goodsDetails": "[{\"goodsId\": \"goodsIdgoodsId\",\"goodsName\": \"goodsNamegoodsName\"}]",
            "customerInfo": "{\"userId\":\"userIduserId\",\"userName\":\"userNameuserName\",\"phone\":\"07011698742\",\"email\":\"test@test.com\"}"
            }'

    response

    {
      "respCode": "00000000",
      "respMsg": "success",
      "data": {
        "orderNo": "2420903032435363613",
        "orderStatus": 1,
        "checkoutUrl": "https://checkout.palmpay.com/h5-checkout/?countryCode=ZA&tntCode=PALMPAYHK&xxx",
        "payToken": "eyJvcmRlck5vIjoiMjQyNDIyMDkwMzAzMjQzNTM2MzYxMyIsInVzZXJJZCI6IjExMCIsInNpZ24iOiIxOEZDNjg5NjNCMDFFNUIyRUJFNzFBNTlGNUQ3MEFFNzBENjZENDc5OEYxMUIxNjMyQjA4QjRFQjA4NDk0OERDIiwia2V5IjoiNGNjYTIzM2Y0MGIxZGZiMWI0NjAwYzdkZmRhZjNlZTIifQ==",
        "orderAmount": 35000,
        "currency": "ZAR"
      }
    }