Open API >Data Service >Registration for Offer Program
Registration for Offer Program
Data Service 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

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

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

③Card holders participate in offer program

④⑤Merchants and Acquirers transmit transaction information

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

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


API Document
API Document
  • 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-Must
Processing type procType AN 2 M-Must 41-Enrollment registration
Signature certificate ID signCertId AN 3 M-Must Signature certificate ID
Encryption certificate ID encCertId AN 3 M-Must Encryption certificate ID
Partner ID insCode ANS 11 M-Must Partner ID configured in the Marketing Platform
Activity ID for enrollment pid N 10 M-Must Activity ID configured in the Marketing Platform. It is used to identify the activity type.
Reference number refNum N 15 M-Must The random number or reference number generated by Partner system.
Request processing time localTime N 14 M-Must Format: YYYYMMDDHHMISS
Time zone where request is processed localTimeZone ANS 9 M-Must 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-Must
Identifier for user userToken AN 50 M-Must The unique identifier for user defined by the Partner.
Card number cardNo N 19 M-Must 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-Must
Processing type procType AN 2 M-Must 41- Enrollment registration
Partner ID insCode ANS 11 M-Must Partner ID configured in the Marketing Platform
Activity ID for enrollment pid N 10 M-Must Return the same value filled in the request message.
Reference number refNum N 15 M-Must Return the same value filled in the request message.
Response code respCode ANS 2 M-Must Response code, see Reponse Code Reference for details.
Response message respMsg ANS 200 M-Must 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.