• 简体中文
  • 创建订单

    适用市场:NG 尼日利亚 | ZA 南非

    请求路径

    /api/v2/payment/merchant/createorder

    NG 和 ZA 共用,参数按通用 → NG 专属 → ZA 专属排列,通过 NG / ZA 列标示各市场必填情况。

    请求参数

    参数类型长度NGZA说明
    orderIdstring32是是商户唯一订单号(幂等控制)
    amountlong—是是交易金额(最小单位:分) NG 最低 100 NGN
    currencystring10是是货币
    notifyUrlstring200是是异步通知接收地址
    callBackUrlstring200是否支付完成后浏览器跳转地址
    nonceStrstring—是是随机字符串(参与签名)
    requestTimeinteger—是是Unix 毫秒时间戳
    versionstring—是是NG:V1.1 · ZA:2.0.0.0
    productTypestring100是是固定 bank_card
          
    titlestring100否否订单标题
    descriptionstring200否否订单描述
    orderExpireTimeinteger—否否过期时间(秒),默认 1800,范围 1800~86400; 未接入PP收银台的可不传
    goodsDetailsstring (JSON)—否否商品详情 JSONArray
    customerInfostring (JSON)—是否客户信息 JSONObject
    remarkstring200否否备注
          
    accessModestring——否默认 redirect direct 直接支付 · redirect 收银台跳转
    captureModestring——否支付模式。默认值:immediate。immediate — 即时支付。授权成功后立即扣款。manual — 预授权。资金被预留但不会立即扣除。必须调用 Capture API 完成请款。授权有效期:7 天。过期后授权自动撤销。请款金额:必须 ≤ 授权金额。未指定时默认全额请款。
    cardPayerInfostring (JSON)——是卡信息或 Token,见 cardPayerInfo

    是 必填 · 否 选填 · — 该市场不适用

    返回值

    字段类型NGZA说明
    orderNostring是是PalmPay 平台订单号
    orderStatusinteger是是订单状态(见订单状态)
    currencystring是是货币代码
    orderAmountlong是是交易金额(分)
         
    messagestring否否状态描述
    checkoutUrlstring否否H5 收银台 URL(accessMode=redirect 时返回)
    payTokenstring否否SDK 支付参数(accessMode=redirect 时返回)
    sdkSessionIdstring否否SDK 安全密钥(accessMode=redirect 时返回)
    sdkSignKeystring否否SDK 安全密钥(accessMode=redirect 时返回)
         
    cardTokenstring—否卡 Token(rememberCard=true 时返回)
    verifyUrlstring—否3DS 认证 URL(需引导持卡人验证)

    是 必定返回 · 否 条件返回 · — 不返回

    ZA 预授权场景注意:查询 auth 订单(captureMode=manual 创建的原始订单)时不返回 cardBrand / cardLast4 / cardCountry / eci,需通过 captureInfo 找到 capture 订单号后再查询 capture 订单获取卡信息。

    示例

    ZA · 卡信息支付下单

    适用于:发起即时支付

    curl 'https://open-gw-daily.palmpay-inc.com/api/v2/payment/merchant/order/queryStatus' \
      -H 'CountryCode: ZA' -H 'Authorization: Bearer xxx' -H 'Content-Type: application/json' \
      -d '{
        "amount": 10,
        "currency": "ZAR",
        "notifyUrl": "/callback/payment",
        "orderId": "{{$randomAlphaNumeric:32}}",
        "callBackUrl": "http://baidu.com?query=tomorrew_will_be_better",
        "nonceStr": "",
        "cardPayerInfo": "{\"cardNo\":\"4000000000000002\",\"cvv\":\"123\",\"expiryYear\":\"26\",\"expiryMonth\":\"12\",\"holderName\":\"zhangg\",\"rememberCard\":true,\"forceThreeDs\":AUTO}",
        "requestTime": 1781247874841,
        "accessMode": "direct",
        "productType": "bank_card",
        "captureMode": "immediate",
        "version": "2.0.0.0"
    }'
    {
      "respCode": "00000000",
      "respMsg": "success",
      "data": {
        {
      "orderNo": "24260612070441956333",
      "orderStatus": 1,
      "payerAccountId": "27d8db869c0a46dfabd6260ec8526ae9",
      "mockCheckoutUrl": "https://checkout-daily.palmpay.com/h5-checkout/mock_test?countryCode=ZA&payToken=BD705B2670481166A40322457790B009&orderNo=24260612070441956333&signKey=SyHWTYv5aa94OiK2DR--tFI3RnyR5os1GFHq1ThVuxc&signSession=24260612070441956333&appId=L251103101598045421481&productType=bank_card",
      "cardToken": "27d8db869c0a46dfabd6260ec8526ae9",
      "merchantName": "caojiangling",
      "sdkSignKey": "SyHWTYv5aa94OiK2DR--tFI3RnyR5os1GFHq1ThVuxc",
      "orderAmount": 10,
      "sdkSessionId": "24260612070441956333",
      "appId": "L251103101598045421481",
      "currency": "ZAR",
      "verifyUrl": "https://ng-apptest.transspay.net/api/finance-switch-adapter/order/3ds-auth-html?upstreamRequestId=20260612D01120304310000000264581717160101&checkSum=e27f242b647939694eb50a4fdaa301938ce471333d3c0e50bf458627bafd2849",
      "goodsName": "Order",
      "merchantNo": "124073009021701",
      "payToken": "BD705B2670481166A40322457790B009"
    }
      }
    }