Open API >Offers & Benefits >Registration for Offer Program
Registration for Offer Program
Offers & Benefits Issuer Non-financial Institutions
Registration for Offer Program enables institutions who have accessed U-rebate System to deliver cardholders' registration information.
API Introduction
API Introduction
What is it?

U-rebate system is a system used for institutions to achieve systematic rebate to cardholders. For institutions who access the U-Rebate System, Registration for Offer Program provide APIs to deliver offer program's registrants' card numbers to U-rebate. Based on card number and transaction information, U-rebate system would calculate rebate volume and return to institutions in real-time. In this way, institutions can inform card holders rebate volume in time, achieving better user experience.

Key Features

Instantaneity

Registration for Offer Program enables institutions to inform card holders of rebate information in real-time


Convenience

Institutions can make use of API to achieve automatic registration in batch. 


When to Use it?

When institutions participated in rebate activities that require card holders to register and keep informed in time.

Who Use it?
Institutions who access U-rebate system, including issuing banks and software developers
Where to Use it?
This API is available globally.
Things to Know

API users are suggested to use both registration and notification interface to enhance card holders' user experience.

Flow Chart
Flow Chart

优惠活动报名业务流程图.png

1. Card holders register for offer program in Issuer or Third-party App

2. Issuers or Third-party Apps deliver registrants’ information to UPI

3. Card holders participate in offer program

4.5. Merchants and Acquirers transmit transaction information

6. UPI returned rebate volume information to Issuers or Third-party Apps

7. Issuers or Third-party Apps inform card holders in real-time


API Reference
API Reference
  • Enrollment Registration
  • Transaction Notification
  • Enrollment Registration Cancellation
  • Transaction Data Synchronization
Interface description
When a customer enrolls and registers his/her person information through the client end of Partner, the background system of Partner uses this interface to submit the enrollment information to the Marketing Platform.
Request Method
HTTP POST
Request Parameter
Field name Identifier Type Length Request Default value Note
header header Object M:Mandatory
Processing type procType AN 2 M:Mandatory 41-Enrollment registration
Signature certificate ID signCertId AN 3 M:Mandatory Signature certificate ID
Encryption certificate ID encCertId AN 3 M:Mandatory Encryption certificate ID
Partner ID insCode ANS 11 M:Mandatory Partner ID configured in the Marketing Platform
Activity ID for enrollment pid N 10 M:Mandatory Activity ID configured in the Marketing Platform. It is used to identify the activity type.
Reference number refNum N 15 M:Mandatory The random number or reference number generated by Partner system.
Request processing time localTime N 14 M:Mandatory Format: YYYYMMDDHHMISS
Time zone where request is processed localTimeZone ANS 9 M:Mandatory GMT is used. Format: GMT+/-xx:xx. E.g., GMT+08:00 for China which locates in East 8 area.
Reserved resvFld ANS 500 O:Optional
data data Object M:Mandatory
Identifier for user userToken AN 50 M:Mandatory The unique identifier for user defined by the Partner.
Card number cardNo N 19 M:Mandatory Card number
Mobile phone number mobile ANS 30 O:Optional Format: +country/region code-mobile number.
Synchronous Response parameters
Filed name Identifier Type Length Request Default value Note
header header Object M:Mandatory
Processing type procType AN 2 M:Mandatory 41- Enrollment registration
Partner ID insCode ANS 11 M:Mandatory Partner ID configured in the Marketing Platform
Activity ID for enrollment pid N 10 M:Mandatory Return the same value filled in the request message.
Reference number refNum N 15 M:Mandatory Return the same value filled in the request message.
Response code respCode ANS 2 M:Mandatory Response code, see Reponse Code Reference for details.
Response message respMsg ANS 200 M:Mandatory Response message, see Reponse Code Reference for details.
Steps to Launch
Steps to Launch

Please submit order in Support Center to contact us.

  • Contact Us
  • If you have any further questions, please register and submit order in your user center.