One-Stop Cross-Border Shopping — Shop the World
UnionPay Content & Service Platform (UCSP) for Channel Partner
UnionPay Content & Service Platform (UCSP) for Service Provider
UnionPay Transportation Solutions
The UnionPay Content & Service Platform (UCSP) establishes a common technology platform, where third party value-added services provided by merchants can be easily distributed to different channels (such as issuers’Apps). Third party value-added services as industry services, includes travel related services, parking services etc., are open source from service providers (merchants) . UCSP not only acts as an aggregated information platform, but also provides transaction interfaces for these services, connecting service providers and distributing channels.
Openness: UCSP connects service providers and distributing channels through a common set of standard APIs.
Flexibility:Apart from standard APIs open on UPI Developer, customized APIs for specific partner are available.
Versatility:UCSP is available to UnionPay App, issuer’s proprietary platforms and white label wallets.
China-oriented: Leverage UnionPay’s resources in Chinese market as well as local industry services outside of China Mainland.
When merchants or other service providers implement with UnionPay App and Issuers' Wallet Products
Login Process:
1. Users log in channel App
2. USCP transfer login information to Industry Partner
3. Industry Partner realize joint login;
Transaction Process:
4. Users place an order in channel App
5. Industry partner call USCP interface
6. Users pay the order and initiate transaction
7. Transaction result is returned to UCSP and Industry Partner
Field name | Identifier | Type | Length | Request | Default value | Note | |||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Message Information | msgInfo | Object | M:Mandatory | ||||||||||||||||||||||||||||||||||||||||||||
|
Transaction Information | trxInfo | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||
|
Certificate and Signature | certificateSignature | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||
|
Field name | Identifier | Type | Length | Request | Default value | Note | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Message Information | msgInfo | Object | M:Mandatory | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Transaction Information | trxInfo | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Certificate and Signature | certificateSignature | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Filed name | Identifier | Type | Length | Request | Default value | Note | |||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Message Information | msgInfo | Object | M:Mandatory | ||||||||||||||||||||||||||||||||||||||||||||
|
Message Response | msgResponse | M:Mandatory | ||||||||||||||||||||||||||||||||||||||||||||
|
Transaction Information | trxInfo | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||
|
Certificate and Signature | certificateSignature | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||
|
Field name | Identifier | Type | Length | Request | Default value | Note | |||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Message Information | msgInfo | Object | M:Mandatory | ||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Transaction Information | trxInfo | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||
|
Certificate and Signature | certificateSignature | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||
|
Filed name | Identifier | Type | Length | Request | Default value | Note | |||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Transaction Information | trxInfo | Object | R:Returned | ||||||||||||||||||||||||||||||||||||||||||||
|
Message Response | msgResponse | M:Mandatory | ||||||||||||||||||||||||||||||||||||||||||||
|
Field name | Identifier | Type | Length | Request | Default value | Note | |||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Message Information | msgInfo | Object | M:Mandatory | ||||||||||||||||||||||||||||||||||||||||||||
|
Transaction Information | trxInfo | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||
|
Certificate and Signature | certificateSignature | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||
|
Filed name | Identifier | Type | Length | Request | Default value | Note | |||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Message Information | msgInfo | Object | M:Mandatory | ||||||||||||||||||||||||||||||||||||||||||||
|
Transaction Information | trxInfo | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||
|
Message Response | msgResponse | M:Mandatory | ||||||||||||||||||||||||||||||||||||||||||||
|
Certificate and Signature | certificateSignature | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||
|
Field name | Identifier | Type | Length | Request | Default value | Note | |||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Message Information | msgInfo | Object | M:Mandatory | ||||||||||||||||||||||||||||||||||||||||||||
|
Transaction Information | trxInfo | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||
|
Certificate and Signature | certificateSignature | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||
|
Filed name | Identifier | Type | Length | Request | Default value | Note | |||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Message Information | msgInfo | Object | M:Mandatory | ||||||||||||||||||||||||||||||||||||||||||||
|
Transaction Information | trxInfo | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||
|
Message Response | msgResponse | M:Mandatory | ||||||||||||||||||||||||||||||||||||||||||||
|
Certificate and Signature | certificateSignature | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||
|
Field name | Identifier | Type | Length | Request | Default value | Note | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Message Information | msgInfo | Object | M:Mandatory | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Transaction Information | trxInfo | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Certificate and Signature | certificateSignature | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Filed name | Identifier | Type | Length | Request | Default value | Note | |||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Message Information | msgInfo | Object | M:Mandatory | ||||||||||||||||||||||||||||||||||||||||||||
|
Transaction Information | trxInfo | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||
|
Message Response | msgResponse | M:Mandatory | ||||||||||||||||||||||||||||||||||||||||||||
|
Certificate and Signature | certificateSignature | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||
|
Field name | Identifier | Type | Length | Request | Default value | Note | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Message Information | msgInfo | Object | M:Mandatory | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Transaction Information | trxInfo | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Message Response | msgResponse | M:Mandatory | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Certificate and Signature | certificateSignature | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Filed name | Identifier | Type | Length | Request | Default value | Note | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Message Information | msgInfo | Object | M:Mandatory | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Transaction Information | trxInfo | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Message Response | msgResponse | M:Mandatory | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Certificate and Signature | certificateSignature | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Field name | Identifier | Type | Length | Request | Default value | Note | |||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Message Information | msgInfo | Object | M:Mandatory | ||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Transaction Information | trxInfo | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||
|
Certificate and Signature | certificateSignature | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||
|
Filed name | Identifier | Type | Length | Request | Default value | Note | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Message Information | msgInfo | Object | M:Mandatory | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Transaction Information | trxInfo | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Message Response | msgResponse | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Certificate and Signature | certificateSignature | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Field name | Identifier | Type | Length | Request | Default value | Note | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Message Information | msgInfo | Object | M:Mandatory | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Transaction Information | trxInfo | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Certificate and Signature | certificateSignature | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Filed name | Identifier | Type | Length | Request | Default value | Note | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Message Information | msgInfo | Object | M:Mandatory | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Transaction Information | trxInfo | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Message Response | msgResponse | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Certificate and Signature | certificateSignature | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Field name | Identifier | Type | Length | Request | Default value | Note | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Message Information | msgInfo | Object | M:Mandatory | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Transaction Information | trxInfo | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Certificate and Signature | certificateSignature | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Filed name | Identifier | Type | Length | Request | Default value | Note | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Message Information | msgInfo | Object | M:Mandatory | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Transaction Information | trxInfo | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Message Response | msgResponse | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Certificate and Signature | certificateSignature | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Field name | Identifier | Type | Length | Request | Default value | Note | |||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Message Information | msgInfo | Object | M:Mandatory | ||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Transaction Information | trxInfo | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||
|
Certificate and Signature | certificateSignature | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||
|
Filed name | Identifier | Type | Length | Request | Default value | Note | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Message Information | msgInfo | Object | M:Mandatory | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Transaction Information | trxInfo | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Message Response | msgResponse | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Certificate and Signature | certificateSignature | Object | M:Mandatory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
1.Authorized Login Flow
▪ Applies to the Channel APPs that provides OAUTH authorization.
▪ Message flow:
1.The user logins on the Channel APP client side and clicks on the Industry Services icon.
2.The Channel APP redirects to the UCSP authorized login interface AUTHORIZATION_URL with parameters including “industryCode” assigned to the Industry Service when the Industry Service first connects to UCSP and “channelCode”. The UCSP receives the access request, and then requests OAUTH authorization from the Channel APP to obtain user login credentials (“userID”, “mobile”). This step describes interactions between Channel APP and the UCSP, and technical details are out of the scope of the UCSP Specs.
3.Having obtained user credentials, the UCSP uses “industryCode” in the AUTHORIZATION_URL to obtain the login page URL of the Industry Service (INDUSTRY_INDEX_URL). Meanwhile, it generates signature based on data such as user credentials (“userId”, “mobile No.”) and forms the INDUSTRY_LOGIN_INFO message as the input parameter “request_data” of login page URL. The UCSP then redirects to the login page of the Industry Service.
4.The Industry Service receives the authorized login requests, and verifies the signature of the parameter data “request_data”. If the verification succeeds, the Industry Service obtains user login credential (“userId” and “mobile”), completes authorized login, and enters the service page.
2. Frontend Payment Flow
▪ Applies to all payment scenarios where the frontend calls the payment SDK.
▪ Message flow:
1.The user clicks on the Submit order button on the Industry Service page displayed in the Channel APP. The Industry Service pushes the order information (“orderId”, “merId”, “acqIIN”, “txnAmt”, “currencyCode”) to the backend of the UCSP in the SUBMIT_PAYMENT_ORDER request.
2.The UCSP backend makes a request to the downstream system to place the order. When the order is placed, it returns the transaction number “tn” and the UCSP cashier page URL “paymentUrl” to the Industry Service backend in the SUBMIT_PAYMENT_ORDER response.
3.The Industry Service backend resolves the cashier page (“paymentUrl”) and returns to the industry page which then redirects to the cashier page. Users can check the order details and click to pay upon confirmation. The page calls the payment SDK of the Channel APP and invokes the cashier module of the client. Users can select cards and confirm payment in the cashier module. Upon acceptance, the payment SDK returns the transaction completion result to the cashier page which redirects to the payment success page.
4.After the UCSP receives the final payment result from downstream system, the UCSP forwards the result to the Industry Service in the PAYMENT_RESULT_NOTICE.
5.In case of network timeout where the backend of the Industry Service does not receive the payment result, the Industry Service can initiate PAYMENT_RESULT_INQUIRY to the UCSP to inquire the result.
3. Backend Payment Flow
▪ Applies to the scenario where the user has signed auto-debit payment in the Channel APP in advance and the backend performs payment automatically without further cardholder verification.
▪ Message flow:
3.1 Auto-debit Payment Signing
1-2.On the Industry Service page, when the user clicks the Sign Auto-debit Payment button, the Industry Service sends SIGN_SUTO_DEBIT to the UCSP, and the Service page will be redirected to the signing page of the Channel APP through UCSP.
3. The user reads the service content and the contract, and clicks to switch on the auto-debit payment service. The Channel APP returns the “contractId” and the contract result to UCSP. The UCSP obtains the “frontUrl” submitted in the SIGN_AUTO_DEBIT interface and redirects to the Industry Service frontend. The Industry Service refreshes its page to display the result.
4. The UCSP obtains the “backUrl” submitted in the SIGN_AUTO_DEBIT interface and pushes the signing result (“contractId”) to the Industry Service backend in SIGN_AUTO_DEBIT_NOTICE. The “contractId” is saved by the Industry Service as a key element of the auto-debit payment.
3.2 Auto-debit Payment Closing
1.On the Industry Service page, when the user clicks the Close Auto-debit Payment button, the Industry Service backend will send the CLOSE_AUTO_DEBIT request to UCSP.
2.Based on the “contractID”, the UCSP calls the auto-debit closing interface to the corresponding contracted Channel APP.
3.When the contract is closed, the Channel APP returns the result to the UCSP backend.
4.The UCSP returns the result to the Industry Service backend in the CLOSE_AUTO_DEBIT response.
3.3 Backend Payment Flow
1.In the payment scenario, the user triggers fee deduction of the Industry Service. The backend submits the automatic debit request SUBMIT_AUTO_DEBIT (“contractId”) to the UCSP. The UCSP forwards the payment request to the downstream auto-debit payment system signed by the user.
2.When the payment result from the Issuer reaches the UCSP, the UCSP returns the result to the Industry Service in PAYMENT_RESULT_NOTICE.
3.In case of network timeout, the Industry Service can inquire the payment result of UCSP through PAYMENT_RESULT_INQUIRY. After the UCSP receives synchronous response, it can initiate payment inquiry at intervals of 0s, 1s, 2s, 4s, 8s, 16s, 32s. The UCSP should stop sending inquiries once it receives successful/failed transaction status or it receives backend notification.
4. Payment Cancellation Flow
1.When the user requires payment cancellation, the Industry Service initiates payment cancellation request PAYMENT_CANCELLATION (“orderId”, “txnTime”, “origQryId”) to the UCSP.
2.The UCSP processes the request and returns the processing result.
3.When the payment result from the Issuer reaches the UCSP, the UCSP returns the result in PAYMENT_RESULT_NOTICE to the Industry Service.
4.In case of network timeout, the Industry Service can inquire the cancellation result by sending REFUND_RESULT_INQUIRY.
5. Refund Flow
1.When the user requires refund, Industry Service initiates refund request PAYMENT_REFUND (“orderId”, “txnTime”, “origQryId”) to the UCSP.
2.The UCSP processes the request and returns the processing result.
3.When the payment result from the Issuer reaches the UCSP, the UCSP returns the result in PAYMENT_RESULT_NOTICE to the Industry Service.
4.In case of network timeout, the Industry Service can inquire the refund result of UCSP by sending REFUND_RESULT_INQUIRY.
When merchants and UnionPay International carry out UCSP business, they will mainly go through steps as "agreement signing", "merchant enrollment", "system development & testing", "going online" and "production verification". Among these steps, “agreement signing”, “merchant enrollment” and “system development & testing” can be conducted in parallel, and other steps need to be carried out in order.
For merchant, please submit ordr including following information: merchant name, country/region, contact person and contact information
Response code | Description |
---|---|
00 | Approved |
01 | Transaction Fail |
05 | Accepted, need to inquiry transaction result |
10 | Message Format Invalid |
11 | Signature Verification Fails |
34 | Transaction Order not Found |
36 | Order Info is Incorrect |
99 | Common Error |