J&T Express Indonesia 数据 API：金币、网点、工单

PT. Global Jet Express · 出行 2.5 ★

J&T Express Indonesia 是极兔速递在印度尼西亚的官方客户应用，由 PT. Global Jet Express（JET）发布。个人与小商家用来查询运单、预约单票或批量揽收、下单前查询运费、维护地址簿、使用优惠券、支付账单并兑换会员积分。登录支持手机号 OTP、6 位 PIN 或 Google；同一账号还可查看附近自助点地图、把 J&T 金币提现到已绑定的印尼银行账户，并提交客服工单。应用面向印尼包裹市场，与 JNE、SiCepat、Anteraja、Ninja Xpress、Lion Parcel 竞争，Google Play 约 13.7 万条评价、评分 2.5 星。

金币管理页把 currentCoin 拆成可花的 availableCoinNum 与 cashbackCoinNum，并受 minCoinConfig 和提现条款标志（isRead、canWithdraw）约束。流水按 coinPageDto 的 transactionType 与 selectRangeTime 分页，每条 IN/OUT/WITHDRAW 带 waybillNo、operateCoin、createTime。提现前报价返回 exchangeAmount、withdrawFee 与 actualArrivalAmount，对应所选 withdrawBankName/withdrawBankAccount；提交后得到 withdrawCode 与 withdrawStatus。已绑定印尼银行账户给出 bankCode、bankAccount、bankUserName（目录行另有 bankId、mappingWithdrawBankName）。

自助点图钉以 siteCode 为键，配上 siteAddr、latitude/longitude、startBusinessTime/endBusinessTime 和 appCusOutletType；城区筛选复用 mappingProvince、mappingCity、mappingDistrict。工单暴露 workOrderNo、关联 waybillNo，以及 handlingOpinionsNoClosed 仍为真时的 statusChangeLogs。会话在 OTP、PIN 或 Google 之后签发 accessToken、cusCode、userId。电商卖家与 3PL 把网点铺进揽收地图，财务机器人按运单对金币返现，资金岗在打到 BCA/Mandiri 前核对 IDR 报价，客服看板盯投诉在 OPEN 停留多久——openData Studio 再把这套表面变成可调用的开放数据。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

查询客户登录方式

POST /v1/session/login-options osint

在登录页之前解析该手机号走 OTP 还是 6 位 PIN（loginType、pinFlag）。

认证方式：无需登录。手机号是 OTP 或 PIN 之前的查找键。

phoneNumber
countryCode
areaCode
loginType
firstTypeName
secondTypeName
pinFlag
pinCodeFlag
smsType
cusCode

POST /v1/session/login-options HTTP/1.1
Content-Type: application/json

{
  "token": "",
  "deviceId": "a1b2c3d4e5f6",
  "params": {
    "phoneNumber": "081234567890",
    "countryCode": "62",
    "areaCode": "+62"
  }
}

{
  "code": "1",
  "success": true,
  "message": "ok",
  "flag": true,
  "data": {
    "loginType": "otp",
    "firstTypeName": "OTP",
    "secondTypeName": "PIN",
    "pinFlag": true,
    "pinCodeFlag": true,
    "smsType": "OTP",
    "cusCode": "CUS21090001"
  }
}

发送短信验证码

POST /v1/session/sms-code osint

为印尼手机号发送短信验证页使用的 OTP（smsType OTP）。

认证方式：无需登录。手机号加 smsType。

phoneNumber
smsType
countryCode
retryOver5Times

POST /v1/session/sms-code HTTP/1.1
Content-Type: application/json

{
  "token": "",
  "deviceId": "a1b2c3d4e5f6",
  "params": {
    "phoneNumber": "081234567890",
    "smsType": "OTP",
    "countryCode": "62"
  }
}

{
  "code": "1",
  "success": true,
  "message": "ok",
  "flag": true,
  "data": {
    "retryOver5Times": false,
    "smsType": "OTP",
    "phoneNumber": "081234567890"
  }
}

OTP 前的验证码开关
POST /v1/session/captcha-gate osint
告知登录页在发送短信 OTP 之前是否必须弹出腾讯 TCaptcha（isOpen）；控件返回 ticket 与 randstr。
认证方式：无需登录。在短信 OTP 之前调用；isOpen 为真时弹出腾讯 TCaptcha（ticket、randstr）。
- isOpen
- ticket
- randstr
```
POST /v1/session/captcha-gate HTTP/1.1
Content-Type: application/json

{
  "token": "",
  "deviceId": "a1b2c3d4e5f6",
  "params": {}
}
```
```
{
  "code": "1",
  "success": true,
  "message": "ok",
  "flag": true,
  "data": {
    "isOpen": true
  }
}
```

客户通用登录

POST /v1/session/customer-token osint

在登录页用 OTP 或 PIN 签发客户会话（accessToken、cusCode、userId）。

认证方式：无需登录。手机号加 verifyCode（OTP）或 pinCode；响应 accessToken 即会话。

phoneNumber
verifyCode
pinCode
smsType
loginType
deviceId
deviceNo
accessToken
token
cusCode
userId
pinCodeFlag
sessionId

POST /v1/session/customer-token HTTP/1.1
Content-Type: application/json

{
  "token": "",
  "deviceId": "a1b2c3d4e5f6",
  "params": {
    "phoneNumber": "081234567890",
    "verifyCode": "123456",
    "pinCode": "",
    "smsType": "OTP",
    "loginType": "otp",
    "deviceId": "a1b2c3d4e5f6",
    "deviceNo": "a1b2c3d4e5f6"
  }
}

{
  "code": "1",
  "success": true,
  "message": "ok",
  "flag": true,
  "data": {
    "accessToken": "<accessToken>",
    "token": "<accessToken>",
    "cusCode": "CUS21090001",
    "userId": "100861001",
    "phoneNumber": "081234567890",
    "loginType": "otp",
    "pinCodeFlag": true,
    "sessionId": "sess-9f3a"
  }
}

Google 登录

POST /v1/session/google-identity osint

在登录页用 Google Sign-In 的 idToken 签发客户会话。

认证方式：无需登录。使用 Google Sign-In 的 idToken 与 serverAuthCode；响应 accessToken 即会话。

idToken
serverAuthCode
displayName
email
emailAddress
deviceId
deviceNo
accessToken
token
cusCode
userId
loginType
pinCodeFlag
sessionId

POST /v1/session/google-identity HTTP/1.1
Content-Type: application/json

{
  "token": "",
  "deviceId": "a1b2c3d4e5f6",
  "params": {
    "idToken": "<google-id-token>",
    "serverAuthCode": "<server-auth-code>",
    "displayName": "Budi Santoso",
    "email": "[email protected]",
    "emailAddress": "[email protected]",
    "deviceId": "a1b2c3d4e5f6",
    "deviceNo": "a1b2c3d4e5f6"
  }
}

{
  "code": "1",
  "success": true,
  "message": "ok",
  "flag": true,
  "data": {
    "accessToken": "<accessToken>",
    "token": "<accessToken>",
    "cusCode": "CUS21090001",
    "userId": "100861001",
    "displayName": "Budi Santoso",
    "email": "[email protected]",
    "loginType": "google",
    "pinCodeFlag": true,
    "sessionId": "sess-9f3a"
  }
}

设置客户 PIN

POST /v1/account/pin/set osint

创建或轮换 PIN 登录页使用的 6 位 PIN（修改时带 oldPinCode）。

认证方式：客户会话：JSON 请求体字段 token（登录签发的 accessToken），外加 method/params 信封与 deviceId。

cusCode
phoneNumber
pinCode
oldPinCode
pinCodeFlag
pinFlag

POST /v1/account/pin/set HTTP/1.1
Content-Type: application/json

{
  "token": "<accessToken>",
  "deviceId": "a1b2c3d4e5f6",
  "params": {
    "cusCode": "CUS21090001",
    "phoneNumber": "081234567890",
    "pinCode": "147258",
    "oldPinCode": ""
  }
}

{
  "code": "1",
  "success": true,
  "message": "ok",
  "flag": true,
  "data": {
    "pinCodeFlag": true,
    "pinFlag": true,
    "cusCode": "CUS21090001"
  }
}

填写推荐码

POST /v1/account/referral opendata

登录后在推荐码页绑定好友推荐码。

认证方式：客户会话：JSON 请求体字段 token（登录签发的 accessToken），外加 method/params 信封与 deviceId。

cusCode
referralCode
oldReferralCode

POST /v1/account/referral HTTP/1.1
Content-Type: application/json

{
  "token": "<accessToken>",
  "deviceId": "a1b2c3d4e5f6",
  "params": {
    "cusCode": "CUS21090001",
    "referralCode": "JTBUDI88",
    "oldReferralCode": ""
  }
}

{
  "code": "1",
  "success": true,
  "message": "ok",
  "flag": true,
  "data": {
    "referralCode": "JTBUDI88",
    "cusCode": "CUS21090001",
    "oldReferralCode": ""
  }
}

当前金币余额

POST /v1/wallet/coins/snapshot openfinance

返回登录客户在金币管理页展示的 J&T 金币钱包快照。

认证方式：客户会话：JSON 请求体字段 token（登录签发的 accessToken），外加 method/params 信封与 deviceId。

cusCode
currentCoin
availableCoinNum
cashbackCoinNum
totalCoinNum
minCoinConfig

POST /v1/wallet/coins/snapshot HTTP/1.1
Content-Type: application/json

{
  "token": "<accessToken>",
  "deviceId": "a1b2c3d4e5f6",
  "params": {
    "cusCode": "CUS21090001"
  }
}

{
  "code": "1",
  "success": true,
  "message": "ok",
  "flag": true,
  "data": {
    "currentCoin": 12500,
    "availableCoinNum": 11800,
    "cashbackCoinNum": 700,
    "totalCoinNum": 12500,
    "minCoinConfig": 1000,
    "cusCode": "CUS21090001"
  }
}

金币流水分页

POST /v1/wallet/coins/ledger openfinance

按 transactionType 与 selectRangeTime 分页返回金币流水（入账/出账/提现）。

认证方式：客户会话：JSON 请求体字段 token（登录签发的 accessToken），外加 method/params 信封与 deviceId。

cusCode
coinPageDto
transactionType
transactionTypeList
selectRangeTime
startTime
endTime
coinNum
operateCoin
waybillNo
createTime
withdrawStatus
orderId

POST /v1/wallet/coins/ledger HTTP/1.1
Content-Type: application/json

{
  "token": "<accessToken>",
  "deviceId": "a1b2c3d4e5f6",
  "params": {
    "cusCode": "CUS21090001",
    "coinPageDto": {
      "transactionType": "ALL",
      "transactionTypeList": [
        "IN",
        "OUT",
        "WITHDRAW"
      ],
      "selectRangeTime": "0-60",
      "startTime": "2026-09-01 00:00:00",
      "endTime": "2026-10-11 23:59:59",
      "page": 1,
      "pageSize": 20
    }
  }
}

{
  "code": "1",
  "success": true,
  "message": "ok",
  "flag": true,
  "data": {
    "list": [
      {
        "coinNum": 250,
        "operateCoin": 250,
        "transactionType": "IN",
        "waybillNo": "JT1234567890ID",
        "createTime": "2026-10-02 14:21:03",
        "withdrawStatus": "",
        "orderId": "ORD-88921"
      }
    ],
    "page": 1,
    "pageSize": 20,
    "total": 36
  }
}

金币提现手续费报价

POST /v1/wallet/coins/payout-quote openfinance

在提交提现之前报价金币兑 IDR 的到账金额（exchangeAmount、withdrawFee、actualArrivalAmount）。

认证方式：客户会话：JSON 请求体字段 token（登录签发的 accessToken），外加 method/params 信封与 deviceId。

cusCode
operateCoin
exchangeAmount
taxFee
withdrawFee
actualArrivalAmount
minCoinConfig
withdrawBankName
withdrawBankAccount
mappingWithdrawBankName

POST /v1/wallet/coins/payout-quote HTTP/1.1
Content-Type: application/json

{
  "token": "<accessToken>",
  "deviceId": "a1b2c3d4e5f6",
  "params": {
    "cusCode": "CUS21090001",
    "operateCoin": 5000,
    "withdrawBankAccount": "1234567890",
    "withdrawBankName": "BCA"
  }
}

{
  "code": "1",
  "success": true,
  "message": "ok",
  "flag": true,
  "data": {
    "operateCoin": 5000,
    "exchangeAmount": 50000,
    "taxFee": 0,
    "withdrawFee": 2500,
    "actualArrivalAmount": 47500,
    "minCoinConfig": 1000,
    "withdrawBankName": "BCA",
    "withdrawBankAccount": "1234567890",
    "mappingWithdrawBankName": "Bank Central Asia"
  }
}

执行金币提现

POST /v1/wallet/coins/payouts openfinance

提交金币到银行账户的提现，返回 withdrawCode 与 withdrawStatus。

认证方式：客户会话：JSON 请求体字段 token（登录签发的 accessToken），外加 method/params 信封与 deviceId。

cusCode
operateCoin
withdrawAmount
withdrawFee
withdrawBankName
withdrawBankAccount
bankUserName
pinCode
withdrawCode
withdrawStatus
actualArrivalAmount
createTime

POST /v1/wallet/coins/payouts HTTP/1.1
Content-Type: application/json

{
  "token": "<accessToken>",
  "deviceId": "a1b2c3d4e5f6",
  "params": {
    "cusCode": "CUS21090001",
    "operateCoin": 5000,
    "withdrawAmount": 50000,
    "withdrawFee": 2500,
    "withdrawBankName": "BCA",
    "withdrawBankAccount": "1234567890",
    "bankUserName": "BUDI SANTOSO",
    "pinCode": "147258"
  }
}

{
  "code": "1",
  "success": true,
  "message": "ok",
  "flag": true,
  "data": {
    "withdrawCode": "WD-20261011-8891",
    "withdrawStatus": "PENDING",
    "operateCoin": 5000,
    "withdrawAmount": 50000,
    "actualArrivalAmount": 47500,
    "createTime": "2026-10-11 09:14:22"
  }
}

金币提现详情

POST /v1/wallet/coins/payouts/detail openfinance

为提现详情页返回单笔提现（withdrawStatus、actualArrivalAmount）。

认证方式：客户会话：JSON 请求体字段 token（登录签发的 accessToken），外加 method/params 信封与 deviceId。

cusCode
withdrawCode
withdrawStatus
operateCoin
withdrawAmount
withdrawFee
actualArrivalAmount
withdrawBankName
withdrawBankAccount
bankUserName
createTime

POST /v1/wallet/coins/payouts/detail HTTP/1.1
Content-Type: application/json

{
  "token": "<accessToken>",
  "deviceId": "a1b2c3d4e5f6",
  "params": {
    "cusCode": "CUS21090001",
    "withdrawCode": "WD-20261011-8891"
  }
}

{
  "code": "1",
  "success": true,
  "message": "ok",
  "flag": true,
  "data": {
    "withdrawCode": "WD-20261011-8891",
    "withdrawStatus": "PENDING",
    "operateCoin": 5000,
    "withdrawAmount": 50000,
    "withdrawFee": 2500,
    "actualArrivalAmount": 47500,
    "withdrawBankName": "BCA",
    "withdrawBankAccount": "1234567890",
    "bankUserName": "BUDI SANTOSO",
    "createTime": "2026-10-11 09:14:22"
  }
}

提现银行目录

POST /v1/wallet/banks/catalog openfinance

列出可接收金币提现的印尼银行（bankCode、bankName、bankImg）。

认证方式：客户会话：JSON 请求体字段 token（登录签发的 accessToken），外加 method/params 信封与 deviceId。

bankName
bankId
bankCode
bankImg
mappingWithdrawBankName

POST /v1/wallet/banks/catalog HTTP/1.1
Content-Type: application/json

{
  "token": "<accessToken>",
  "deviceId": "a1b2c3d4e5f6",
  "params": {
    "bankName": ""
  }
}

{
  "code": "1",
  "success": true,
  "message": "ok",
  "flag": true,
  "data": {
    "list": [
      {
        "bankId": "014",
        "bankCode": "CENAIDJA",
        "bankName": "BCA",
        "bankImg": "https://static.example.com/bank/bca.png",
        "mappingWithdrawBankName": "Bank Central Asia"
      }
    ]
  }
}

客户已绑定银行账户

POST /v1/wallet/banks/linked openfinance

返回客户已绑定、用于金币提现的银行账户。

认证方式：客户会话：JSON 请求体字段 token（登录签发的 accessToken），外加 method/params 信封与 deviceId。

cusCode
bankId
bankCode
bankName
bankAccount
bankUserName
bankImg
bankFileImg

POST /v1/wallet/banks/linked HTTP/1.1
Content-Type: application/json

{
  "token": "<accessToken>",
  "deviceId": "a1b2c3d4e5f6",
  "params": {
    "cusCode": "CUS21090001"
  }
}

{
  "code": "1",
  "success": true,
  "message": "ok",
  "flag": true,
  "data": {
    "list": [
      {
        "bankId": "014",
        "bankCode": "CENAIDJA",
        "bankName": "BCA",
        "bankAccount": "1234567890",
        "bankUserName": "BUDI SANTOSO",
        "bankImg": "https://static.example.com/bank/bca.png",
        "bankFileImg": ""
      }
    ]
  }
}

绑定提现银行账户

POST /v1/wallet/banks/link openfinance

在添加银行页用 PIN 确认后绑定用于金币提现的印尼银行账户。

认证方式：客户会话：JSON 请求体字段 token（登录签发的 accessToken），外加 method/params 信封与 deviceId。

cusCode
pinCode
appBindBankDto
bankId
bankCode
bankName
bankAccount
bankUserName
bankImg
bankFileImg

POST /v1/wallet/banks/link HTTP/1.1
Content-Type: application/json

{
  "token": "<accessToken>",
  "deviceId": "a1b2c3d4e5f6",
  "params": {
    "cusCode": "CUS21090001",
    "pinCode": "147258",
    "appBindBankDto": {
      "bankId": "014",
      "bankCode": "CENAIDJA",
      "bankName": "BCA",
      "bankAccount": "1234567890",
      "bankUserName": "BUDI SANTOSO",
      "bankImg": "https://static.example.com/bank/bca.png",
      "bankFileImg": ""
    }
  }
}

{
  "code": "1",
  "success": true,
  "message": "ok",
  "flag": true,
  "data": {
    "bankId": "014",
    "bankCode": "CENAIDJA",
    "bankName": "BCA",
    "bankAccount": "1234567890",
    "bankUserName": "BUDI SANTOSO",
    "cusCode": "CUS21090001"
  }
}

按 GPS 查找附近网点

POST /v1/outlets/nearby opendata

为附近网点地图列出附近 J&T 自助点/网点，含营业时间与距离。

认证方式：客户会话：JSON 请求体字段 token（登录签发的 accessToken），外加 method/params 信封与 deviceId。

latitude
longitude
localLatitude
localLongitude
siteCode
siteName
siteAddr
sitePhone
siteLeader
siteUrl
distance
startBusinessTime
endBusinessTime
businesshours
street
appCusOutletName
appCusOutletType
mappingCity
mappingProvince
mappingDistrict
postalCode

POST /v1/outlets/nearby HTTP/1.1
Content-Type: application/json

{
  "token": "<accessToken>",
  "deviceId": "a1b2c3d4e5f6",
  "params": {
    "latitude": -6.2088,
    "longitude": 106.8456,
    "localLatitude": -6.2088,
    "localLongitude": 106.8456
  }
}

{
  "code": "1",
  "success": true,
  "message": "ok",
  "flag": true,
  "data": {
    "list": [
      {
        "siteCode": "CGK001",
        "siteName": "J&T Drop Point Menteng",
        "siteAddr": "Jl. Menteng Raya No. 12, Jakarta Pusat",
        "sitePhone": "0213900000",
        "siteLeader": "Andi",
        "siteUrl": "",
        "latitude": -6.1967,
        "longitude": 106.8326,
        "distance": 1.4,
        "startBusinessTime": "08:00",
        "endBusinessTime": "20:00",
        "businesshours": "08:00-20:00",
        "street": "Jl. Menteng Raya No. 12",
        "appCusOutletName": "Drop Point Menteng",
        "appCusOutletType": "DROP_POINT",
        "mappingCity": "Jakarta Pusat",
        "mappingProvince": "DKI Jakarta",
        "mappingDistrict": "Menteng",
        "postalCode": "10310"
      }
    ]
  }
}

按城区查找网点

POST /v1/outlets/by-district opendata

按城市区域列表选中的省/市/区列出网点。

认证方式：客户会话：JSON 请求体字段 token（登录签发的 accessToken），外加 method/params 信封与 deviceId。

mappingProvince
mappingCity
mappingDistrict
mappingCountyarea
cityID
siteCode
siteName
siteAddr
sitePhone
latitude
longitude
appCusOutletType
startBusinessTime
endBusinessTime
postalCode

POST /v1/outlets/by-district HTTP/1.1
Content-Type: application/json

{
  "token": "<accessToken>",
  "deviceId": "a1b2c3d4e5f6",
  "params": {
    "mappingProvince": "DKI Jakarta",
    "mappingCity": "Jakarta Pusat",
    "mappingDistrict": "Menteng",
    "mappingCountyarea": "Menteng",
    "cityID": "JK01"
  }
}

{
  "code": "1",
  "success": true,
  "message": "ok",
  "flag": true,
  "data": {
    "list": [
      {
        "siteCode": "CGK001",
        "siteName": "J&T Drop Point Menteng",
        "siteAddr": "Jl. Menteng Raya No. 12, Jakarta Pusat",
        "sitePhone": "0213900000",
        "latitude": -6.1967,
        "longitude": 106.8326,
        "appCusOutletType": "DROP_POINT",
        "startBusinessTime": "08:00",
        "endBusinessTime": "20:00",
        "mappingCity": "Jakarta Pusat",
        "mappingDistrict": "Menteng",
        "cityID": "JK01",
        "postalCode": "10310"
      }
    ]
  }
}

帮助 FAQ 列表

POST /v1/help/articles opendata

为帮助中心页返回分组 FAQ 文章（faqCode、title、content）。

认证方式：客户会话：JSON 请求体字段 token（登录签发的 accessToken），外加 method/params 信封与 deviceId。

lang
faqList
faqCode
title
content
groupName

POST /v1/help/articles HTTP/1.1
Content-Type: application/json

{
  "token": "<accessToken>",
  "deviceId": "a1b2c3d4e5f6",
  "params": {
    "lang": "EN"
  }
}

{
  "code": "1",
  "success": true,
  "message": "ok",
  "flag": true,
  "data": {
    "faqList": [
      {
        "faqCode": "FAQ-TRACK-01",
        "title": "How do I track a shipment?",
        "content": "Enter the waybill number on the tracking screen.",
        "groupName": "Tracking"
      }
    ]
  }
}

工单列表

POST /v1/support/tickets opendata

分页返回客户工单（workOrderNo、waybillNo、未关闭处理意见）。

认证方式：客户会话：JSON 请求体字段 token（登录签发的 accessToken），外加 method/params 信封与 deviceId。

cusCode
handlingOpinionsNoClosed
workOrderNo
waybillNo
orderId
status
creatorPhone
groupName
createTime
title

POST /v1/support/tickets HTTP/1.1
Content-Type: application/json

{
  "token": "<accessToken>",
  "deviceId": "a1b2c3d4e5f6",
  "params": {
    "cusCode": "CUS21090001",
    "page": 1,
    "pageSize": 20,
    "handlingOpinionsNoClosed": true
  }
}

{
  "code": "1",
  "success": true,
  "message": "ok",
  "flag": true,
  "data": {
    "list": [
      {
        "workOrderNo": "WO-20261009-441",
        "waybillNo": "JT1234567890ID",
        "orderId": "ORD-88921",
        "status": "OPEN",
        "handlingOpinionsNoClosed": true,
        "creatorPhone": "081234567890",
        "groupName": "Delivery",
        "createTime": "2026-10-09 11:02:18",
        "title": "Failed delivery attempt"
      }
    ],
    "page": 1,
    "total": 4
  }
}

工单详情

POST /v1/support/tickets/detail opendata

为工单详情页返回含 statusChangeLogs 的单条工单。

认证方式：客户会话：JSON 请求体字段 token（登录签发的 accessToken），外加 method/params 信封与 deviceId。

workOrderNo
cusCode
waybillNo
orderId
status
title
content
creatorPhone
groupName
handlingOpinionsNoClosed
statusChangeLogs
createTime

POST /v1/support/tickets/detail HTTP/1.1
Content-Type: application/json

{
  "token": "<accessToken>",
  "deviceId": "a1b2c3d4e5f6",
  "params": {
    "workOrderNo": "WO-20261009-441",
    "cusCode": "CUS21090001"
  }
}

{
  "code": "1",
  "success": true,
  "message": "ok",
  "flag": true,
  "data": {
    "workOrderNo": "WO-20261009-441",
    "waybillNo": "JT1234567890ID",
    "orderId": "ORD-88921",
    "status": "OPEN",
    "title": "Failed delivery attempt",
    "content": "Courier could not reach the recipient.",
    "creatorPhone": "081234567890",
    "groupName": "Delivery",
    "handlingOpinionsNoClosed": true,
    "statusChangeLogs": [
      {
        "status": "OPEN",
        "createTime": "2026-10-09 11:02:18"
      }
    ],
    "createTime": "2026-10-09 11:02:18"
  }
}

校验客户 PIN

POST /v1/account/pin/verify osint

在金币提现或绑卡前，于 PIN 登录页校验 6 位 PIN。

认证方式：客户会话：JSON 请求体字段 token（登录签发的 accessToken），外加 method/params 信封与 deviceId。

cusCode
phoneNumber
pinCode
pinCodeFlag
pinFlag

POST /v1/account/pin/verify HTTP/1.1
Content-Type: application/json

{
  "token": "<accessToken>",
  "deviceId": "a1b2c3d4e5f6",
  "params": {
    "cusCode": "CUS21090001",
    "phoneNumber": "081234567890",
    "pinCode": "147258"
  }
}

{
  "code": "1",
  "success": true,
  "message": "ok",
  "flag": true,
  "data": {
    "pinCodeFlag": true,
    "pinFlag": true,
    "cusCode": "CUS21090001"
  }
}

更换客户手机号

POST /v1/account/phone/rebind osint

在安全设置页经短信校验后，把登录客户的手机号改绑到新 MSISDN。

认证方式：客户会话：JSON 请求体字段 token（登录签发的 accessToken），外加 method/params 信封与 deviceId。

cusCode
phoneNumber
verifyCode
smsType
userId

POST /v1/account/phone/rebind HTTP/1.1
Content-Type: application/json

{
  "token": "<accessToken>",
  "deviceId": "a1b2c3d4e5f6",
  "params": {
    "cusCode": "CUS21090001",
    "phoneNumber": "081298765432",
    "verifyCode": "654321",
    "smsType": "OTP"
  }
}

{
  "code": "1",
  "success": true,
  "message": "ok",
  "flag": true,
  "data": {
    "cusCode": "CUS21090001",
    "phoneNumber": "081298765432",
    "userId": "100861001"
  }
}

解绑提现银行账户

POST /v1/wallet/banks/unlink openfinance

在银行列表页用 PIN 确认后解绑已绑定的提现账户。

认证方式：客户会话：JSON 请求体字段 token（登录签发的 accessToken），外加 method/params 信封与 deviceId。

cusCode
pinCode
bankId
bankCode
bankAccount

POST /v1/wallet/banks/unlink HTTP/1.1
Content-Type: application/json

{
  "token": "<accessToken>",
  "deviceId": "a1b2c3d4e5f6",
  "params": {
    "cusCode": "CUS21090001",
    "pinCode": "147258",
    "bankId": "014",
    "bankCode": "CENAIDJA",
    "bankAccount": "1234567890"
  }
}

{
  "code": "1",
  "success": true,
  "message": "ok",
  "flag": true,
  "data": {
    "cusCode": "CUS21090001",
    "bankAccount": "1234567890",
    "bankCode": "CENAIDJA",
    "bankId": "014"
  }
}

金币提现条款未读标记
POST /v1/wallet/coins/terms-status openfinance
告知金币管理页客户是否已同意金币提现条款（isRead / judgeIsRead），未同意则 canWithdraw 为假、不能提交提现。
认证方式：客户会话：JSON 请求体字段 token（登录签发的 accessToken），外加 method/params 信封与 deviceId。
- cusCode
- isRead
- judgeIsRead
- canWithdraw
```
POST /v1/wallet/coins/terms-status HTTP/1.1
Content-Type: application/json

{
  "token": "<accessToken>",
  "deviceId": "a1b2c3d4e5f6",
  "params": {
    "cusCode": "CUS21090001"
  }
}
```
```
{
  "code": "1",
  "success": true,
  "message": "ok",
  "flag": true,
  "data": {
    "isRead": false,
    "judgeIsRead": false,
    "canWithdraw": false,
    "cusCode": "CUS21090001"
  }
}
```

金币提现条款正文

POST /v1/wallet/coins/terms openfinance

返回条款页展示的金币提现条款正文（content）以及当前 isRead 标记。

认证方式：客户会话：JSON 请求体字段 token（登录签发的 accessToken），外加 method/params 信封与 deviceId。

cusCode
content
isRead

POST /v1/wallet/coins/terms HTTP/1.1
Content-Type: application/json

{
  "token": "<accessToken>",
  "deviceId": "a1b2c3d4e5f6",
  "params": {
    "cusCode": "CUS21090001"
  }
}

{
  "code": "1",
  "success": true,
  "message": "ok",
  "flag": true,
  "data": {
    "content": "J&T coin cash-out terms…",
    "isRead": false,
    "cusCode": "CUS21090001"
  }
}

标记金币提现条款已读

POST /v1/wallet/coins/terms-ack openfinance

记录客户已同意金币提现条款，使随后条款状态检查的 canWithdraw 变为真。

认证方式：客户会话：JSON 请求体字段 token（登录签发的 accessToken），外加 method/params 信封与 deviceId。

cusCode
isRead
canWithdraw

POST /v1/wallet/coins/terms-ack HTTP/1.1
Content-Type: application/json

{
  "token": "<accessToken>",
  "deviceId": "a1b2c3d4e5f6",
  "params": {
    "cusCode": "CUS21090001"
  }
}

{
  "code": "1",
  "success": true,
  "message": "ok",
  "flag": true,
  "data": {
    "isRead": true,
    "canWithdraw": true,
    "cusCode": "CUS21090001"
  }
}

数据类别

客户登录令牌
短信 OTP 与 PIN 标志
J&T 金币钱包余额
金币流水与提现
已绑定银行账户
自助点与网点位置
FAQ 文章
客户工单
Google 登录令牌
推荐码
银行账户绑定写入
PIN 校验
手机号改绑
腾讯 TCaptcha 开关
金币提现条款同意

数据使用场景与案例

揽收网点覆盖地图
3PL 或电商平台把 GPS/城区定位返回的 siteCode、siteAddr、经纬度与 startBusinessTime/endBusinessTime 铺到地图上，让卖家看到附近哪些极兔自助点在营业。
卖家金币对账
财务机器人读取 currentCoin 与 availableCoinNum，再分页拉取 coinPageDto 流水（waybillNo、operateCoin、transactionType），把返现对上已发运单。
提现通道核验
提现前资金岗核对已绑定银行（bankAccount、bankUserName、bankCode）以及金币兑 IDR 报价（withdrawFee、actualArrivalAmount），确保 IDR 打到正确的 BCA/Mandiri 账户。
客服工单时效监控
客服看板筛 handlingOpinionsNoClosed 工单，再读每条工单详情的 statusChangeLogs，看运单投诉在 OPEN 状态停留了多久。

常见问题

J&T Express Indonesia 如何鉴权客户？

登录方式查询告知该手机号走 OTP 还是 6 位 PIN（loginType、pinFlag）；短信验证码下发后，通用登录或 Google idToken 换票返回 accessToken、cusCode 与 userId。之后的调用在 JSON 请求体 token 字段以及 method/params 信封里携带该令牌。

能读到哪些金币钱包字段？

钱包快照返回 currentCoin、availableCoinNum、cashbackCoinNum 与 minCoinConfig；分页流水按 waybillNo、operateCoin、transactionType 列出；提现报价在提交前给出 exchangeAmount、withdrawFee 与 actualArrivalAmount，提交后得到 withdrawCode/withdrawStatus。

可以列出极兔自助点和已绑定银行吗？

可以。GPS 定位用经纬度返回 siteCode、siteAddr、distance 与 startBusinessTime/endBusinessTime；城区定位按 mappingProvince、mappingCity、mappingDistrict 筛同一套网点卡片。已绑定提现账户给出 bankCode、bankAccount、bankUserName。

这些是公开的开发者 API 吗？

不是。它们是登录后的客户应用发出的第一方调用。除登录、OTP 和验证码开关外都需要客户的 accessToken。

与 J&T Express Indonesia 相似的应用

JNE Express — JNE Express（PT Tiki Jalur Nugraha Ekakurir）是 1990 年成立于雅加达的快递公司，可追踪运单并查询印尼国内运费，是极兔在本地最常被对照的承运商。
SiCepat Ekspres — SiCepat Ekspres 是 2014 年成立的印尼物流公司，网站和应用可查运单、预约揽收、查询运费，并提供 BEST 次日达、普通件、HALU 经济件和货到付款。
Anteraja — Anteraja 是 PT Tri Adi Bersama 的包裹品牌，为 Adi Sarana Armada 于 2019 年 3 月在雅加达成立的物流子公司，通过客户应用提供次日达、当日达和普通件。
Ninja Xpress — Ninja Xpress 是新加坡 Ninja Van 的印尼末端品牌；该公司 2014 年成立，在印尼以轴辐网络派送包裹，并承接 Tokopedia、Lazada 和 Shopee 的电商件。
Lion Parcel — Lion Parcel 是狮航集团旗下 PT Lion Express 的快递品牌，2013 年成立，可在印尼及 50 多个国家预约经济件或特快件，并支持货到付款。
TIKI — TIKI（Titipan Kilat）是印尼快递公司，网站可查运单、估算运费，并预约当日达、隔夜达、普通件、经济件、卡车货运和国际件。
Pos Indonesia — Pos Indonesia 是印尼国营邮政，通过 PosAja 办理信函与包裹，并依托全国柜台网点，作为民营极兔运单的国家邮政对照。
DHL Express Mobile — DHL Express Mobile 是 DHL 官方 Android 客户端，用于货件跟踪，印尼发件人常把它与极兔国内运单并列使用，处理限时国际件。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

J&T Express Indonesia 数据 API：金币、网点、工单

应用截图

API 端点一览

查询客户登录方式

发送短信验证码

OTP 前的验证码开关

客户通用登录

Google 登录

设置客户 PIN

填写推荐码

当前金币余额

金币流水分页

金币提现手续费报价

执行金币提现

金币提现详情

提现银行目录

客户已绑定银行账户

绑定提现银行账户

按 GPS 查找附近网点

按城区查找网点

帮助 FAQ 列表

工单列表

工单详情

校验客户 PIN

更换客户手机号

解绑提现银行账户

金币提现条款未读标记

金币提现条款正文

标记金币提现条款已读

数据类别

数据使用场景与案例

揽收网点覆盖地图

卖家金币对账

提现通道核验

客服工单时效监控

常见问题

相关应用

与 J&T Express Indonesia 相似的应用

更多出行类应用

99 Motorista e Entregador

Amazon Flex

Australia Post

Borzo: Courier Delivery App

相关主题

需要集成这个 App 的数据 API？