跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://developers-sandbox.uqpaytech.com/llms.txt

Use this file to discover all available pages before exploring further.

实体卡需要 PIN 码进行交易身份验证。UQPAY 还支持配置免密阈值，让持卡人无需输入 PIN 码即可完成小额购物。
PIN 码设置仅适用于实体卡。虚拟卡不使用 PIN 码。

​
激活时设置 PIN 码

激活实体卡时必须设置 PIN 码。在 Activate Card 请求中加入 pin 字段： 
curl -X POST https://api-sandbox.uqpaytech.com/api/v1/issuing/cards/activate \
  -H "x-auth-token: YOUR_API_TOKEN" \
  -H "x-idempotency-key: $(uuidgen | tr '[:upper:]' '[:lower:]')" \
  -H "Content-Type: application/json" \
  -d '{
    "card_id": "b2c1b725-d8f1-4fbb-88a1-41bf9ffc8ead",
    "activation_code": "81534005",
    "pin": "123456"
  }'

​
重置 PIN 码

使用 Reset Card PIN 接口修改卡片 PIN 码： 
curl -X POST https://api-sandbox.uqpaytech.com/api/v1/issuing/cards/pin \
  -H "x-auth-token: YOUR_API_TOKEN" \
  -H "x-idempotency-key: $(uuidgen | tr '[:upper:]' '[:lower:]')" \
  -H "Content-Type: application/json" \
  -d '{
    "card_id": "b2c1b725-d8f1-4fbb-88a1-41bf9ffc8ead",
    "pin": "567890"
  }'

​
免密支付阈值

no_pin_payment_amount 参数设置一个交易金额阈值，低于该金额的交易无需输入 PIN 码。这能优化小额、高频消费（尤其是非接触式支付）的结账体验。

​
默认行为

条件行为
未设置 no_pin_payment_amount不超过 200 SGD 的交易免密
no_pin_payment_amount 设为 0所有交易都需要 PIN 码
no_pin_payment_amount 设为某个值不超过该金额的交易免密
以 USD 签发的卡片，默认阈值对应 200 SGD 按当前汇率换算后的 USD 等值金额。

​
支持范围

币种范围
USD0 – 2,000
SGD0 – 2,600

​
支持的 BIN

环境BIN
生产49372410、49372408、49372434、45659910
沙盒40963608

​
配置阈值

更新卡片时设置 no_pin_payment_amount： 
curl -X POST https://api-sandbox.uqpaytech.com/api/v1/issuing/cards/{card_id} \
  -H "x-auth-token: YOUR_API_TOKEN" \
  -H "x-idempotency-key: $(uuidgen | tr '[:upper:]' '[:lower:]')" \
  -H "Content-Type: application/json" \
  -d '{
    "no_pin_payment_amount": 500
  }'

​
交易决策逻辑

授权结果取决于三个因素：卡片是否设置了 PIN 码、是否配置了自定义免密限额、以及交易金额。
是否有 PIN是否配置免密限额交易金额结果
是否≤ 200 SGD免密通过（或输入正确 PIN 码通过）。PIN 码错误则拒绝。
是否> 200 SGD需要 PIN 码。未输入或输入错误则拒绝。
是是（例如 500 SGD）≤ 自定义限额免密通过（或输入正确 PIN 码通过）。PIN 码错误则拒绝。
是是（例如 500 SGD）> 自定义限额需要 PIN 码。未输入或输入错误则拒绝。
如果卡片未设置 PIN 码，也未配置免密限额，大额交易会因缺少身份验证凭证而失败。激活卡片时务必设置 PIN 码。