Open API Reference for Bluepay

# 1.1 Add Ticket

# URL

  • {domain}/open-api/bluepay/abnormalTransIssue/addIssueFromOpen

# Method

  • POST

# Request Header

Parameter name Required Type of data Description
Content-Type Y string application/json

# Request Param

Parameter name Required Type of data limit example Description
appId Y string - - APP ID
param Y string - - param
sign Y string - 45eebd745dcf0b5f6d6f9fcde28cd9fe8116a892 sign

# param

Parameter name Required Type of data Description
requestId Y string requestId
mchOrderId Y string mchOrderId，Letter+number, maximum length 32
amount Y integer amount，Unit: Division
ticketType Y integer ticketType， 1.Abnormal transaction status
payerType Y integer payerType，1.rider 2.Recipient 3.Other payers
courierMobile Y string courierMobile，Mobile phone format: 06, 08, 09+8 digits (10 digits in total) landline phone format: 02, 03, 04, 05, 07+7 digits (9 digits in total)
payerMobile Y string When the payer is not a rider, it is required. When the payer is a rider, it does not need to be filled in. The format is the same as CourierMobile
transactionDate Y string transactionDate， yyyy-MM-dd (example：2023-10-01)
notifyUrl Y string Work order processing result notification URL
problemDescription Y string problemDescription，Up to 500 characters
proofImage Y List proofImage ，Maximum five

# Response parameters

Parameter name Type of data Description
requestId string requestId
ticketNo string ticket Number

# Request example

# Param content

{
  "requestId": "wwtestce20252902",
  "mchOrderId": "wwwwentestmchOrderId2705",
  "amount": 100000,
  "ticketType": 1,
  "payerType": 2,
  "courierMobile": "0611111111",
  "payerMobile": "0611111112",
  "transactionDate": "2025-10-29",
  "notifyUrl": "https://webhook.site/2eadaa58-8d72-43b6-baa5-fd9206b55627",
  "problemDescription": "problemDescription",
  "proofImage": [
    "bluepay/onboard/extern/22fe507ee71d04cee1665b9879164724.jpg",
    "bluepay/onboard/extern/ec6a0b833f7def2bf05664f7c2ca491b.jpeg",
    "bluepay/onboard/extern/c40354a007efc7db10cc6a69e4ab00ba.jpeg",
    "bluepay/onboard/extern/b34acd761cf197176d89995e556e58d7.png",
    "bluepay/onboard/extern/71336c315e0ca0909c614583a7efaf52.pdf"
  ]
}

# Request body

{
  "sign": "45eebd745dcf0b5f6d6f9fcde28cd9fe8116a892",
  "appId": "3d717fb236534ef0a63f7c44c25260c6",
  "param": "{\"requestId\":\"wwtestce20252902\",\"mchOrderId\":\"wwwwentestmchOrderId2705\",\"amount\":100000,\"ticketType\":1,\"payerType\":2,\"courierMobile\":\"0611111111\",\"payerMobile\":\"0611111112\",\"transactionDate\":\"2025-10-29\",\"notifyUrl\":\"https://webhook.site/2eadaa58-8d72-43b6-baa5-fd9206b55627\",\"problemDescription\":\"problemDescription\",\"proofImage\":[\"bluepay/onboard/extern/22fe507ee71d04cee1665b9879164724.jpg\",\"bluepay/onboard/extern/ec6a0b833f7def2bf05664f7c2ca491b.jpeg\",\"bluepay/onboard/extern/c40354a007efc7db10cc6a69e4ab00ba.jpeg\",\"bluepay/onboard/extern/b34acd761cf197176d89995e556e58d7.png\",\"bluepay/onboard/extern/71336c315e0ca0909c614583a7efaf52.pdf\"]}"
}

# Response example

{
  "code": 10000,
  "message": "Success",
  "data": {
    "requestId": "testce2025300932",
    "ticketNo": "202511031059144551"
  }
}

← 1.2 Processing result query →