Documents

# Quick Start

The client can contact the TripLink business team to begin the business onboarding process. We will create the TripLink test account for you after the business onboarding process.

TripLink provides both Web portal and API. You can experience the TripLink product with the test account, or access the API directly based on your business scenario.

# Preparation

If your company want to access the API, please complete the below process through the TripLink Web portal.

Please contact TripLink if you have any questions.

1 Customer Info

The following customer information are provided by TripLink，the test environment and production environment need to be provided separately.

CustomerId：the unique identifier of your company

MCC：merchant category code

Authorized administrator account：used to login Web portal

TEST ENV: https://triplink.uat.ctripqa.com/webapp/yago/login (opens new window)

PRO ENV: https://vcc.triplinkintl.com/webapp/yago/login (opens new window)

2 Customer AES key and RES public key

Please apply for AES key and RSA public key through the TripLink Web portal for your company.

AES Key: used for data encryption and decryption between both parties, 128 bits (Base64 encoded).

RES key: TripLink uses it to verify your request signature, 2048 bits (Base64 encoded).

TEST and PROD：must use different AES keys and RSA public keys

TEST ENV: https://triplink.uat.ctripqa.com/webapp/yago/customer/apiConfig (opens new window)

PRO ENV: https://vcc.triplinkintl.com/webapp/yago/customer/apiConfig (opens new window)

api_encryption_key_config

3 TripLink RSA public key

Provided by TripLink, your company uses it to verify our response signature, 2048 bits (Base64 encoded).

TEST ENV: MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAzGuvnpECqBJlD2Rk8eQ3BiNJn6TglMxC+BIzj7g2xOBF1wrn7vDgO40uNwF42SSDbQ2eb9lOyslhFlNZFeasCwKFLQ/uo0HY2vFlFBb49362OL1aYIf3hCgL7J2+4U6vUlrZkm0HWSZm5KMT/Y39hjTPSvaTQQPYBFgbderPIw1CS7hQpOh6MMp6XqdzPEdKWZ431A60wYV89BAd5n5hrlAWXeWsnzsO9FK1AHnDhH8FGkIsxYaZsVAAHwWIk1WLnKTWLLJSJjH+0qG7LwWcnlZDe22xza+LzszgyBcQ3f2jio1KD+xpXGN+qqa9jjuwFUx3qcdURRS53j1qRVhuFwIDAQAB

PROD ENV: MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAyKVF9vPwaYQBxaXSlennNssTK8w3pM04Ytim8zAKSrLKWHPsmVVxcZc23A3MQUSCifr6vtLCygujbxb/macskWSJZXTtcL1Cqu1dgUtAEOA9MUTLr1qlrOwFHF91ZvGLxgHafsSwcmiHY/fPTpquZax7VvCPGT3rpU4q9UqtvMhl3dsxDaseI2H6aNKjv6SO4/kO2s+dUFVQONiSncWcWv2gvKpDWL4fhNFvS2Px7HewbUsKcZbAhC2SIuU3QUNTVcX7uaZNasqmCnAjxAMMPawlW3GXj2wVX2pOIFhWx6rOcy+QTVkNLa7Eok9KpEmOdaJ9skMbnaoQ35QaWyLk5QIDAQAB

4 Customer server IP (Optional)

If your company's server has fixed public IP, please configure an IP whitelist on the Web portal to increase communication security.

TEST ENV: https://triplink.uat.ctripqa.com/webapp/yago/customer/apiConfig (opens new window)

PRO ENV: https://vcc.triplinkintl.com/webapp/yago/customer/apiConfig (opens new window)

ip_whitelist_config

TripLink fixed public IP:

环境 IP
TEST
(domestic)		 58.221.127.201
TEST
(overseas)		 45.251.106.248
45.251.106.249
PROD
(domestic)		 114.80.56.0 ~ 114.80.56.255 (114.80.56.0/24, 256 IP)
211.95.54.0 ~ 211.95.54.255 (211.95.54.0/24, 256 IP)
180.163.115.0 ~ 180.163.115.255 (180.163.115.0/24, 256 IP)
220.196.164.0 ~ 220.196.164.255 (220.196.164.0/24 , 256 IP)
PROD
(overseas)		 103.48.141.160 ~ 103.48.141.191 (103.48.141.160/27, 32 IP)
45.251.106.192 ~ 45.251.106.255 (45.251.106.192/26, 64 IP)
210.13.85.208 ~ 210.13.85.215 ( 8 IP)
103.158.15.66 ~ 103.158.15.75 (10 IP)
PROD
(domestic & overseas)		 13.215.20.68
13.215.244.111
13.251.210.55
3.0.231.183
3.1.154.233
52.220.173.239
52.76.118.225
54.251.39.235
13.215.38.60
18.141.29.106

5 VAN Default Configuration (Optional)

You can configure default configuration through the Web portal.

TEST ENV: https://triplink.uat.ctripqa.com/webapp/yago/customer/globalParmeter (opens new window)

PRO ENV: https://vcc.triplinkintl.com/webapp/yago/customer/globalParmeter (opens new window)

6 Callback Service (Optional)

If your company needs authorization notification and authorization decision, please configure these settings on the Web portal.

You can view and modify the parameters for Authorization Result Notification and Authorization Decision Callback here, as well as view submission history.

If the address you submitted is not on the whitelist, it will go through an approval process before taking effect. (The test environment refreshes every hour, and the production environment refreshes at 1am every day.)

TEST ENV: https://triplink.uat.ctripqa.com/webapp/yago/customer/callbackParameter (opens new window)

PRO ENV: https://vcc.triplinkintl.com/webapp/yago/customer/callbackParameter (opens new window)

callback_config

Authorization Notification URL: TripLink will send the authorization result to this customer interface asynchronously after the authorization is completed.

Notification Switch: Whether to enable the authorization notification function (Disabled by default).

Authorization Decision URL: TripLink will call back this customer interface before approving the authorization request, and the customer can use this to implement their own risk control and authorization decisions.

Decision Switch: Whether to enable the authorization decision function (Disabled by default).

Fallback Policy: When the authorization decision interface times out or encounters an exception, TripLink will use the default decision result for the customer (Default is rejection).

7 Report Service (Optional)

If your company want to receive the TripLink report file through SFTP, please configure the SFTP IP whitelist through the Web portal.

After a successful application, you will receive an email notification. Once TripLink reviews and approves your application, another email will be sent providing SFTP login certificate.

Only support the PRO environment

PRO ENV: https://vcc.triplinkintl.com/webapp/yago/customer/sftpConfig (opens new window)

sftp_whitelist_config

The unencrypted file only contains masked card number. If you need 16 digits card number, please provide 4096 bits PGP public key for file encryption, can be generated at RSA key pair generator (opens new window).

# How to use

You can develop based on our SDK, or based on our API document. Currently we have Java and PHP SDK, other language support is on the way.

# Testing

After completing above steps, you can start testing. TripLink provides a Merchant self-service testing platform, you can mock various types of operation. Please check Testing to use our testing platform.

# Production Release

TripLink will work with you to check the log during testing. Once there is no issue, TripLink will create the merchant account, open and configure the network access in production environment. You can start the production release once you received your merchant configuration.