By continuing your navigation on our website, you consent to the use of cookies to provide you with better services. To learn more, read our cookies policy.
x
APIs
Products & Solutions
Partner
Support
Sign in
Search
International
中国站
Open API >Offers & Benefits >Cardholder Instant Discount Usage Query
Cardholder Instant Discount Usage Query
Offers & Benefits Merchant Acquirer Issuer
Through this interface, users can query the usage of instant discount offer for a specific card number.
Sandbox Testing
API Introduction
API Introduction
What is it?

Instant discount is used by developers to obtain  information related to offers. After browsing promotion from partners’ websites, Apps or WeChat Official Accounts, App users and UnionPay cardholders can access offers. Through this interface,  users can query the usage of instant discount offer for a specific card number.

When to Use it?

When users want to  query the usage of instant discount offer for a specific card number.

Who Use it?
Cardholders can access various offer channels, including the websites and apps of issuers and merchants.
Where to Use it?
This API is available globally
Flow Chart
Flow Chart

持卡人立减活动查询-流程图.png

Access Flow:

Agency call APIs to  query the usage of instant discount offer for a specific card number.

UPI returns response data
API Reference
API Reference
  • Cardholder Instant Discount Usage Query
Interface description
This API is used to query the cardholder instant discount info.
Request Method
HTTP POST
Request Parameter
Field name Identifier Type Length Request Default value Note
procType procType an 2 M:Mandatory
signCertId signCertId an 3 M:Mandatory
encCertId encCertId an 3 M:Mandatory
insCode insCode ans 11 M:Mandatory
pid pid n 10 M:Mandatory
scenId scenId ans 4 O:Optional
refNum refNum n 15 M:Mandatory
localTime localTime n 14 M:Mandatory
localTimeZone localTimeZone ans 9 M:Mandatory
resvFld resvFld ans 500 O:Optional
data data None
userToken userToken an 50 M:Mandatory
cardNo cardNo n 19 M:Mandatory
mobile mobile ans 30 O:Optional
Synchronous Response parameters
Filed name Identifier Type Length Request Default value Note
procType procType an 2 M:Mandatory
insCode insCode ans 11 M:Mandatory
dayAmt dayAmt ns 15 O:Optional
dayCnt dayCnt n 10 O:Optional
monthAmt monthAmt ns 15 O:Optional
monthCnt monthCnt n 10 O:Optional
ttlAmt ttlAmt ns 15 M:Mandatory
ttlCnt ttlCnt n 10 M:Mandatory
discCurr discCurr n 3 M:Mandatory
refNum refNum n 15 M:Mandatory
respCode respCode ans 2 M:Mandatory
respMsg respMsg ans 200 M:Mandatory
  • Contact Us
  • If you have any further questions, please register and submit order in your user center.
©Copyright 2002 - 2023. All rights reserved