UnionPay International Developer

Open API >Offers & Benefits >Merchant Offer

Merchant Offer

Offers & Benefits Developer Acquirer Issuer

Merechant's Offer provides massive offer information of UnionPay international, as well as the merchant and store information related to the offer.

Sandbox Testing

API Introduction

What is it?

Merchant Offers API provides access to UnionPay International's central offer repository, so as to enable users to promote merchant offers to their cardholders on multilingual custom applications or pages. All the information is simultaneously managed and updated for users to access the latest offers as soon as they become available.

Key Features

In-depth Cooperation

It helps API users to cooperate closely with partners who display UnionPay international offers and provide offer store data with latitude and longitude to facilitate partners' secondary development.

Sychronized Information Update

Get the daily changed offer information of UnionPay international through the interface, and keep pace with the offer information of UnionPay International's official website.

When to Use it?

1) The cardholder inquires about the offer according to the specific merchant.

2) The cardholder queries the acquiring merchant according to the merchant offer type

3) According to the merchant's data, the offer nearby will be secondary developed to facilitate UPI cardholders

Who Use it?

Acquirer, Issuers, Third-party App manufacturers

Where to Use it?

This API is available globally

Flow Chart

数据调用类流程图.png

Access Flow:

1. API Caller apply to use APIs

2. UPI approve application, update white list and generate key pair, then provide API Caller the public key and user ID (appID)

Call Flow:

3. API Caller uses the public key to encrypt the request message which include caller’s user identity information

4. UPI verify API Caller’s identity, decrypt request message, and return response data encrypted by using private key.

API Reference

Query of the active offer participating merchant list
Query of merchant details
Query of the active offer participating store list
Query of store details
Query of the offer list
Query of offer details
Notification on the list query result

Interface description

This operation allows a member institution to query UPI for the merchant list updated within a certain period of time. The returned result only contains the merchant information related to the offers available for the institution's offer list. UPI returns the result based on specific parameters in the request message.

Request Method

HTTP GET/POST

Request Parameter

Field name

Identifier

Type

Length

Request

Default value

Note

Message information

msgInfo

Object

M:Mandatory

Language	lang	ANS	1–5	M:Mandatory	zh: Simplified Chinese en: English Default value: zh
Message ID	msgId	AN	17–49	M:Mandatory	"M00001034 420171230235959000000"	"M" is used to indicate this request is generated from a member institution's system.Components: "M"+INS ID+Serial Number The components of the response message are the same as those of the request message.
Timestamp	timeStamp	N	14	M:Mandatory	"20170714235959"	Beijing Time Format:YYYYMMDDhhmmss
Message type	msgType	ANS	15	M:Mandatory	""	"ACTIVEOFFER_MERCHANT_LIST_QUERY"
Institution code	insCode	AN	8–11	M:Mandatory	"200010344"	Code of the member institution (assigned by the system)

Transaction information

trxInfo

Object

None

Start time of merchant information update	merchantUpdateFrom	N	8	M:Mandatory	By default, "20180101" indicates that the start time is 00:00.The time cannot be earlier than the last update date in the response message with the processing result that is successfully received.	Start date (Beijing Time) of merchant information modification format: YYYYMMDD
End time of merchant information update	merchantUpdateEnd	N	8	M:Mandatory	By default, "20180101" indicates that the end time is 24:00.	End date (Beijing Time) of merchant information modification format: YYYYMMDD
Page number	pageIndex	N	1–4	M:Mandatory	"1"	Number of the page to be queried in a paging query. For example, to query the records on page 8 among a total of 15 pages of records, fill in 8. To query records from the start, fill in 1.
Number of records per page	pageRows	N	1–2	M:Mandatory	"10"	Number of records returned per page in a paging query

Synchronous Response parameters

Filed name

Identifier

Type

Length

Request

Default value

Note

Message information

msgInfo

Object

M:Mandatory

Language	lang	ANS	1–5	M:Mandatory	zh: Simplified Chinese en: English Default value: zh
Message ID	msgId	AN	17–49	M:Mandatory	"M00001034 420171230235959000000"	"M" is used to indicate this request is generated from a member institution's system. Components: "M"+INS ID+Serial Number The components of the response message are the same as those of the request message.
Timestamp	timeStamp	N	14	M:Mandatory	"20170714235959"	Beijing Time format:YYYYMMDDhhmmss
Message type	msgType	ANS	15	M:Mandatory	""	"ACTIVEOFFER_MERCHANT_LIST_QUERY"
Institution code	insCode	AN	8–11	M:Mandatory	"200010344"	Code of the member institution (assigned by the system)

Transaction information

trxInfo

Object

None

Total records

totalRows

1–5

M:Mandatory

Total number of records that meet the search criteria

Total pages

totalIndex

1–4

M:Mandatory

Total number of pages

Data information

dataList

List

M:Mandatory

Country or region code	countryCode	N	3	M:Mandatory		Country where a merchant is headquartered
Merchant name	merchantName	S	1–64	M:Mandatory
Merchant ID	merchantId	ANS	1–15	M:Mandatory		ID of the merchant
Merchant status	status	S	2	M:Mandatory	00: normal 04: invalid	Status of the merchant
Merchant URL	officialWebsite	ANS	1–255	M:Mandatory		Official website of the merchant

Message response

msgResponse

M:Mandatory

Interface description

This operation allows a member institution to query the details of a merchant. The returned result only contains the merchant information related to the offers available for the institution's offer list.

Request Method

HTTP POST

Request Parameter

Field name

Identifier

Type

Length

Request

Default value

Note

Message information

msgInfo

Object

M:Mandatory

Language	lang	ANS	1–5	M:Mandatory	zh: Simplified Chinese en: English Default value: zh
Message ID	msgId	AN	17–49	M:Mandatory	"M00001034 420171230235959000000"	"M" is used to indicate this request is generated from a member institution's system.Components: "M"+INS ID+Serial Number The components of the response message are the same as those of the request message.
Timestamp	timeStamp	N	14	M:Mandatory	"20170714235959"	"20170714235959" (Beijing Time) format: YYYYMMDDhhmmss
Message type	msgType	ANS	8	M:Mandatory		"MERCHANT_DETAIL_QUERY"
Institution code	insCode	AN	8–11	M:Mandatory	"200010344"	Code of the member institution

Details

trxInfo

Object

None

Synchronous Response parameters

Filed name

Identifier

Type

Length

Request

Default value

Note

Message information

msgInfo

Object

M:Mandatory

Language	lang	ANS	1–5	M:Mandatory	zh: Simplified Chinese en: English Default value: zh
Message ID	msgId	AN	17–49	M:Mandatory	"M00001034 420171230235959000000"	"M" is used to indicate this request is generated from a member institution's system.Components: "M"+INS ID+Serial Number The components of the response message are the same as those of the request message.
Timestamp	timeStamp	N	14	M:Mandatory	"20170714235959"	"20170714235959" (Beijing Time) format: YYYYMMDDhhmmss
Message type	msgType	ANS	8	M:Mandatory		"MERCHANT_DETAIL_QUERY"
Institution code	insCode	AN	8–11	M:Mandatory	"200010344"	Code of the member institution

Details

trxInfo

Object

None

Merchant ID	merchantId	ANS	1–15	M:Mandatory		ID of the merchant
Merchant status	status	S	2	M:Mandatory	00: normal 04: invalid	Status of the merchant
Country or region code	countryCode	N	3	M:Mandatory		Country where the merchant is headquartered. For details, see dictionary table 7.1.
Merchant name	merchantName	S	1–100	M:Mandatory	Example: MICHAEL KORS
Merchant category	StoreCategoryCode	S	1–16	M:Mandatory	2	Category of the merchant. For example, "02" is returned for the shopping category. For details, see dictionary table 7.2.
Merchant thumbnail URL	thumbnailImg	S	1–255	O:Optional		Image file URL
Merchant details image URL	detailImg	S	1–255	O:Optional		Image file URL
Merchant introduction	merchantIntro	S	1–10000	O:Optional		Brand profile of the merchant

Message response

msgResponse

M:Mandatory

Interface description

This operation allows a member institution to query UPI for the store list updated within a certain period of time. The returned result only contains the store information related to the offers available for the institution's offer list. UPI returns the result based on specific parameters in the request message.

Request Method

HTTP POST

Request Parameter

Field name

Identifier

Type

Length

Request

Default value

Note

Message information

msgInfo

Object

M:Mandatory

Language	lang	ANS	1–5	M:Mandatory	zh: Simplified Chinese en: English Default value: zh
Message ID	msgId	AN	30	M:Mandatory	"Q00001034420171230235959000000"	"M" is used to indicate this request is generated from a member institution's system. Components: "M"+INS ID+Serial Number The components of the response message are the same as those of the request message.
Timestamp	timeStamp	N	14	M:Mandatory	"20170714235959"	Beijing Time YYYYMMDDhhmmss
Message type	msgType	ANS	15	M:Mandatory		"ACTIVEOFFER_STORE_LIST_QUERY"
Institution code	insCode	AN	8–11	M:Mandatory	"200010344"	Code of the member institution

Transaction information

trxInfo

Object

None

Start time of store information update	storeUpdateFrom	N	8	M:Mandatory	By default, "20180101" indicates that the start time is 00:00.The time cannot be earlier than the last update date in the response message with the processing result that is successfully received.	Start date of store information update(Beijing Time)format:YYYYMMDD
End time of store information update	storeUpdateEnd	N	8	M:Mandatory	By default, "20180101" indicates that the end time is 24:00.	End date of store information update (Beijing Time) format:YYYYMMDD
Page number	pageIndex	N	1–4	M:Mandatory	"1"	Number of the page to be queried in a paging query. For example, to query the records on page 8 among a total of 15 pages of records, fill in 8. To query records from the start, fill in 1.
Number of records per page	pageRows	N	1–2	M:Mandatory	"10"	Number of records returned per page in a paging query

Synchronous Response parameters

Filed name

Identifier

Type

Length

Request

Default value

Note

Message information

msgInfo

Object

M:Mandatory

Language	lang	ANS	1–5	M:Mandatory	zh: Simplified Chinese en: English Default value: zh
Message ID	msgId	AN	30	M:Mandatory	"Q00001034420171230235959000000"	"M" is used to indicate this request is generated from a member institution's system.Components: "M"+INS ID+Serial NumberThe components of the response message are the same as those of the request message.
Timestamp	timeStamp	N	14	M:Mandatory	"20170714235959"	Beijing Time format:YYYYMMDDhhmmss
Message type	msgType	ANS	15	M:Mandatory		"ACTIVEOFFER_STORE_LIST_QUERY"
Institution code	insCode	AN	8–11	M:Mandatory	"200010344"	Code of the member institution

Transaction information

trxInfo

Object

None

Total records

totalRows

1–5

M:Mandatory

Total number of records that meet the search criteria

Total pages

totalIndex

1–4

M:Mandatory

Total number of pages

Data information

dataList

List

M:Mandatory

Country or region code	countryCode	N	3	M:Mandatory		For details, see dictionary table 7.1.
City name	cityName	S	1–64	O:Optional
Store name	storeName	S	1–100	M:Mandatory	Example: MICHAEL KORS (located in Tomorrow Plaza)
Store ID	storeId	ANS	1–30	M:Mandatory		ID of the store
Store status	status	S	2	M:Mandatory	00: normal 04: invalid	Status of the store
Merchant ID	merchantId	ANS	1–15	M:Mandatory		ID of the affiliated merchant
Store category	storeCategoryCode	S	1–16	M:Mandatory		01: shopping 02: catering```

Message response

msgResponse

M:Mandatory

Interface description

This operation allows a member institution to query the details of a store. The returned result only contains the store information related to the offers available for the institution's offer list.

Request Method

HTTP POST

Request Parameter

Field name

Identifier

Type

Length

Request

Default value

Note

Message information

msgInfo

Object

M:Mandatory

Language	lang	ANS	1–5	M:Mandatory	zh: Simplified Chinese en: English Default value: zh
Message ID	msgId	AN	30	M:Mandatory	"Q00001034420171230235959000000"	"M" is used to indicate this request is generated from a member institution's system.Components: "M"+INS ID+Serial Number The components of the response message are the same as those of the request message.
Timestamp	timeStamp	N	14	M:Mandatory	"20170714235959"	Beijing Time format:YYYYMMDDhhmmss
Message type	msgType	ANS	8	M:Mandatory		"STORE_ DETAIL_QUERY"
Institution code	insCode	AN	8–11	M:Mandatory	"200010344"	Code configured by the traffic portal institution on the marketing platform

Transaction information

trxInfo

Object

None

Synchronous Response parameters

Filed name

Identifier

Type

Length

Request

Default value

Note

Message information

msgInfo

Object

M:Mandatory

Language	lang	ANS	1–5	M:Mandatory	zh: Simplified Chinese en: English Default value: zh
Message ID	msgId	AN	30	M:Mandatory	"Q00001034420171230235959000000"	"M" is used to indicate this request is generated from a member institution's system. Components: "M"+INS ID+Serial Number The components of the response message are the same as those of the request message.
Timestamp	timeStamp	N	14	M:Mandatory	"20170714235959"	Beijing Time YYYYMMDDhhmmss
Message type	msgType	ANS	8	M:Mandatory		"STORE_ DETAIL_QUERY"
Institution code	insCode	AN	8–11	M:Mandatory	"200010344"	Code configured by the traffic portal institution on the marketing platform

Transaction information

trxInfo

Object

None

Store ID	storeId	ANS	1–15	M:Mandatory		ID of the store to be queried
Store status	status	S	2	M:Mandatory	00: normal 04: invalid	Status of the store
Affiliated merchant ID	merchantId	ANS	1–15	M:Mandatory		ID of the affiliated merchant
Continent	locationContinentCode	ANS	1–11	O:Optional		Continent where the merchant is located
Country or region code	countryCode	N	3	M:Mandatory		Country or region code, that is, the first-level administrative region where the merchant is located. For details, see dictionary table 7.1.
State or province	provinceCode	S	1–10	O:Optional		Second-level administrative region where the merchant is located
City name	cityName	S	1–64	O:Optional		City or third-level geographical division where the merchant is located
Detailed address	sourceAddress	ANS	1–4000	O:Optional		Detailed address of the merchant
Store name	storeName	S	1–100	M:Mandatory	Example: MICHAEL KORS (located in Tomorrow Plaza)	Name of the merchant (address or location)
Store category	storeCategoryCode	S	1–16	M:Mandatory	1	Code of the category to which the store belongs. For example, "01" is returned for the gourmet category. For details, see data dictionary table 7.2.
Store subcategory	storeSubCategoryCode	S	1–16	M:Mandatory	1	Code of the subcategory to which the store belongs. For example, "01" is returned for the Southeast Asian cuisine subcategory. For details, see dictionary table 7.2.
Online store or not	onlineFlag	S	1	M:Mandatory		Whether the store is an online store (0: no; 1: yes)
Longitude	lng	ANS	10	O:Optional		Longitude
Latitude	lat	ANS	10	O:Optional		Latitude
Business circle	businessCircle	List		O:Optional		Business circle where the store is located
Business hours	businessHours	AN	1–200	O:Optional		Business hours (local time)
Store thumbnail URL	thumbnailImg	S	1–20	O:Optional		Image file URL
Store details image URL	detailImg	S	1–20	O:Optional		Image file URL
Mall name	marketName	ANS	1–10	O:Optional		Name of the mall where the store is located
Contact phone number	tel	NS	1–16	O:Optional		Contact phone number of the store. Multiple phone numbers are separated by commas (,).

Message response

msgResponse

M:Mandatory

Interface description

This operation allows a member institution to query UPI for the offer list updated within a certain period of time. UPI returns the result based on specific parameters in the request message.

Request Method

HTTP POST

Request Parameter

Field name

Identifier

Type

Length

Request

Default value

Note

Message information

msgInfo

Object

M:Mandatory

Language	lang	ANS	1–5	M:Mandatory	zh: Simplified Chinese en: English Default value: zh
Message ID	msgId	AN	30	M:Mandatory	"M00001034420171230235959000000"	"M" is used to indicate this request is generated from a member institution's system. Components: "M"+INS ID+Serial Number The components of the response message are the same as those of the request message.
Timestamp	timeStamp	N	14	M:Mandatory	"20170714235959"	Beijing Time format: YYYYMMDDhhmmss
Message type	msgType	ANS	15	M:Mandatory		"OFFER_LIST_QUERY"
Institution code	insCode	AN	8–11	M:Mandatory	"200010344"	Code of the member institution

Transaction information

trxInfo

Object

None

Start time of offer information update	offerUpdateFrom	N	8	O:Optional	"20180101"The time cannot be earlier than the last update date in the response message with the processing result that is successfully received.	Start time (Beijing Time) of updating online offer information within a certain period of time format:YYYYMMDD
End time of offer information update	offerupdatedend	N	8	O:Optional	"20180101"	End time (Beijing Time) of updating online offer information within a certain period of time format:YYYYMMDD
Page number	pageIndex	N	1–4	M:Mandatory	"1"	Number of the page to be queried in a paging query. For example, to query the records on page 8 among a total of 15 pages of records, fill in 8. To query records from the start, fill in 1.
Number of records per page	pageRows	N	1–2	M:Mandatory	"10"	Number of records returned per page in a paging query

Synchronous Response parameters

Filed name

Identifier

Type

Length

Request

Default value

Note

Message information

msgInfo

Object

M:Mandatory

Language	lang	ANS	1–5	M:Mandatory	zh: Simplified Chinese en: English Default value: zh
Message ID	msgId	AN	30	M:Mandatory	"M00001034420171230235959000000"	"M" is used to indicate this request is generated from a member institution's system. Components: "M"+INS ID+Serial Number The components of the response message are the same as those of the request message.
Timestamp	timeStamp	N	14	M:Mandatory	"20170714235959"	Beijing Time format:YYYYMMDDhhmmss
Message type	msgType	ANS	8	M:Mandatory		"OFFER_LIST_QUERY"
Institution code	insCode	AN	8–11	M:Mandatory	"200010344"	Code of the member institution

Transaction information

trxInfo

Object

None

Total records

totalRows

1–5

M:Mandatory

Total number of records that meet the search criteria

Total pages

totalIndex

1–4

M:Mandatory

Total number of pages

Data information

dataList

List

M:Mandatory

Offer ID	offerId	ANS	1–30	M:Mandatory		Code of the offer configured on the marketing platform
Offer status	status	S	2	M:Mandatory	00: normal 96: invalid	Status of the offer
Offer start time	offerStartDate	N	14	M:Mandatory	44039.458333333336	Start time of the offer, which is precise to seconds and in Beijing Time by default format: YYYYMMDDhhmmss
Offer end time	offerEndDate	N	14	M:Mandatory	44161.416655092595	End time of the offer, which is precise to seconds and in Beijing Time by default format: YYYYMMDDhhmmss
Offer title	offerTitle	S	1–60	M:Mandatory	44161.416655092595	Short title of the marketing offer
Offer name	OfferName	S	1–500	M:Mandatory		Full name of the marketing offer

Message response

msgResponse

M:Mandatory

Interface description

This operation allows a member institution to query the details of an offer.

Request Method

HTTP POST

Request Parameter

Field name

Identifier

Type

Length

Request

Default value

Note

Message information

msgInfo

Object

M:Mandatory

Language	lang	ANS	1–5	M:Mandatory	zh: Simplified Chineseen: English Default value: zh
Message ID	msgId	AN	30	M:Mandatory	"M00001034420171230235959000000"	"M" is used to indicate this request is generated from a member institution's system.Components: "M"+INS ID+Serial Number The components of the response message are the same as those of the request message.
Timestamp	timeStamp	N	14	M:Mandatory	"20170714235959"	Beijing Time format:YYYYMMDDhhmmss
Message type	msgType	ANS	8	M:Mandatory		"OFFER_DETAIL_QUERY"
Institution code	insCode	AN	8–11	M:Mandatory	"200010344"	Code configured by the traffic portal institution on the marketing platform

Details

trxInfo

Object

None

Synchronous Response parameters

Filed name

Identifier

Type

Length

Request

Default value

Note

Message information

msgInfo

Object

M:Mandatory

Language	lang	ANS	1–5	M:Mandatory	zh: Simplified Chinese en: English Default value: zh
Message ID	msgId	AN	30	M:Mandatory	"M00001034420171230235959000000"	"M" is used to indicate this request is generated from a member institution's system. Components: "M"+INS ID+Serial Number The components of the response message are the same as those of the request message.
Timestamp	timeStamp	N	14	M:Mandatory	"20170714235959"	Beijing Time format:YYYYMMDDhhmmss)
Message type	msgType	ANS	8	M:Mandatory		"OFFER_DETAIL_QUERY"
Institution code	insCode	AN	8–11	M:Mandatory	"200010344"	Code configured by the traffic portal institution on the marketing platform

Details

trxInfo

Object

None

Offer ID	offerId	ANS	1–30	M:Mandatory		Code of the offer configured on the marketing platform
Offer status	status	S	2	M:Mandatory	00: normal 96: invalid	Status of the offer
Offer start time	offerStartDate	N	14	M:Mandatory		Start time of the offer, which is precise to seconds and in Beijing Time by default
Offer end time	offerEndDate	N	14	M:Mandatory		End time of the offer, which is precise to seconds and in Beijing Time by default
Offer title	offerTitle	S	1–60	M:Mandatory		Short title of the marketing offer
Offer name	offerName	S	1–500	M:Mandatory		Full name of the marketing offer
Offer type	offerType	N	1–128	M:Mandatory		Type of the marketing offer. For details, see dictionary table 7.3.
Offer content	offerContent	S	1–10000	M:Mandatory		Content of the marketing offer
Offer rules	offerRule	S	1–10000	M:Mandatory		Rules of the marketing offer
Exemption clauses	exception Clause	S	1–3000	M:Mandatory		Exception clauses of the marketing offer
Payment methods	payMethods	N	2	M:Mandatory	Mobile flash payment, QR code scan, card swiping, card insertion, card scan, and online payment	Payment methods supported by the offer. For details, see dictionary table 7.5.
Applicable card types	offerCardLevel	N	2–1000	M:Mandatory	All UnionPay cards, UnionPay Platinum Card, and UnionPay Debit Card	Card types supported by the offer. For details, see dictionary table 7.4.
Applicable card type description	applicableCardsIntro	S	1–4000	M:Mandatory	"UnionPay Diamond Card, UnionPay Platinum Card, UnionPay trip.com Card, UnionPay Business Card, and Asia Prestige Card (card number starting with 62)"	Additional textual description of the types of cards that can be used for the offer, which can be displayed directly.
Offer participating store list	storeList	List	1–4096	M:Mandatory		List of stores participating in the offer, which are separated by commas (,)
Offer participating merchant list	merchantList	List	1–4096	M:Mandatory		List of merchants participating in the offer, which are separated by commas (,)
Offer details image URL	offerDetailName	S	1–255	M:Mandatory		Image file URL
Barcode static image URL	barStaticFileName	S	1–255	C:Conditional		When uplanType is set to 1, an image file URL may exist.
QR code static image URL	qrStaticFileName	S	1–255	C:Conditional		When uplanType is set to 1, an image file URL may exist.
Online coupon code	onlineOfferCode	S	1–128	C:Conditional		When uplanType is set to 1, the marketing offer may provide an online coupon code.
Merchant direct URL	onlineMerUrl	S	1–255	O:Optional		Merchant URL that provides a specific coupon code
Online registration URL	onlineRegUrl	S	1–255	O:Optional		Merchant URL used for offer registration
Card issuing area logic	offerIssrAreaLogic	S	1	O:Optional	"only", "unlimited","except"	Used in conjunction with the countries involved in the issuing area logic
Countries involved in the card issuing area logic	offerIssrAreaLogicList	S	1–4096	O:Optional		Countries involved in the card issuing area logic. For details, see dictionary table 7.7.
Offer attachment URL	attachmentUrl	S	200	O:Optional		Offer attachment URL
Offer keywords	pmtKeywords	S	16	O:Optional		Offer keywords

Message response

msgResponse

M:Mandatory

Interface description

When a member institution queries the last page of updated data, this operation returns all updated data that is successfully processed until the query deadline. After receiving a response message from the UPI, the system saves the data to the database and the next query starts from the date that falls on the date immediately after the last query deadline.

Request Method

HTTP POST

Request Parameter

Field name

Identifier

Type

Length

Request

Default value

Note

Message information

msgInfo

Object

M:Mandatory

Message ID	msgId	AN	30	M:Mandatory	"M00001034420171230235959000000"	"M" is used to indicate this request is generated from a member institution's system.Components: "M"+INS ID+Serial Number The components of the response message are the same as those of the request message.
Timestamp	timeStamp	N	14	M:Mandatory	"20170714235959"	Beijing Time format:YYYYMMDDhhmmss
Message type	msgType	ANS	15	M:Mandatory		"Inquiry_Result_Notify"
Institution code	insCode	AN	8–11	M:Mandatory	"200010344"	Code configured by the traffic portal institution on the marketing platform

Details

trxInfo

Object

None

Synchronous Response parameters

Filed name

Identifier

Type

Length

Request

Default value

Note

Message information

msgInfo

Object

M:Mandatory

Message ID	msgId	AN	30	M:Mandatory	"M00001034420171230235959000000"	"M" is used to indicate this request is generated from a member institution's system.Components: "M"+INS ID+Serial Number The components of the response message are the same as those of the request message.
Timestamp	timeStamp	N	14	M:Mandatory	"20170714235959"	Beijing Time format:YYYYMMDDhhmmss
Message type	msgType	ANS	15	M:Mandatory		"Inquiry_Result_Notify"
Institution code	insCode	AN	8–11	M:Mandatory	"200010344"	Code configured by the traffic portal institution on the marketing platform

Details

trxInfo

Object

None

Message response

msgResponse

M:Mandatory

Steps to Launch

1) Fill in the business application form and submit it to the business department according to the offer type .

2)Simultaneously complete sandbox test and submit test results for review.

3) Transfer to production and go live after approval authority of business department

Please contact Developer operation team by submitting order.

Card Product

Online Payment

Mobile QuickPass

QR Code

Cross-Border B2B Service

Token Program

SaaS Card Issuing Service Platform

Block Chain

Platforms

Global Service

Digital Solutions

Industry Solutions

Deferred Online ODA Mode

Real-Time Mode

Frictionless Parking

Transit QR Code Mode

Prompt

Kindly Reminder

Prompt