# 快速接入

接入方可以联系TripLink商务团队洽谈商务流程,在商务流程完成后我们会为您开通TripLink商户测试端的账号。

TripLink提供Web界面API两种方式。您可以通过测试账号在Web端体验TripLink产品,也可以直接接入TripLink API。

# 准备工作

如果贵公司需要接入API,需要在TripLink Web端自主完成以下申请。

如有疑问,请联系TripLink团队。

1 商户信息

由TripLink提供以下商户信息,测试环境和生产环境需要分别提供.

商户号: 商户的唯一标识。

MCC:商户类别代码

授权管理员账号和密码,用于登录Web端

登录测试环境: https://triplink.uat.ctripqa.com/webapp/yago/login (opens new window)

登录生产环境: https://vcc.triplinkintl.com/webapp/yago/login (opens new window)

2 商户AES密钥、RSA密钥

由贵公司在Web端申请AES密钥、RSA密钥。

AES密钥用于双方对传输数据的加密与解密, 128位(Base64 编码)。

RSA密钥用于TripLink对请求签名的验证,2048位(Base64 编码)。

测试与生产环境:分别需要申请不同的AES密钥、RSA密钥

测试环境: https://triplink.uat.ctripqa.com/webapp/yago/customer/apiConfig (opens new window)

生产环境: https://vcc.triplinkintl.com/webapp/yago/customer/apiConfig (opens new window)

api_encryption_key_config

3 TripLink RSA公钥

由TripLink提供,用于贵公司对响应签名的验证,2048位(Base64 编码)。

测试环境:MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAzGuvnpECqBJlD2Rk8eQ3BiNJn6TglMxC+BIzj7g2xOBF1wrn7vDgO40uNwF42SSDbQ2eb9lOyslhFlNZFeasCwKFLQ/uo0HY2vFlFBb49362OL1aYIf3hCgL7J2+4U6vUlrZkm0HWSZm5KMT/Y39hjTPSvaTQQPYBFgbderPIw1CS7hQpOh6MMp6XqdzPEdKWZ431A60wYV89BAd5n5hrlAWXeWsnzsO9FK1AHnDhH8FGkIsxYaZsVAAHwWIk1WLnKTWLLJSJjH+0qG7LwWcnlZDe22xza+LzszgyBcQ3f2jio1KD+xpXGN+qqa9jjuwFUx3qcdURRS53j1qRVhuFwIDAQAB

生产环境:MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAyKVF9vPwaYQBxaXSlennNssTK8w3pM04Ytim8zAKSrLKWHPsmVVxcZc23A3MQUSCifr6vtLCygujbxb/macskWSJZXTtcL1Cqu1dgUtAEOA9MUTLr1qlrOwFHF91ZvGLxgHafsSwcmiHY/fPTpquZax7VvCPGT3rpU4q9UqtvMhl3dsxDaseI2H6aNKjv6SO4/kO2s+dUFVQONiSncWcWv2gvKpDWL4fhNFvS2Px7HewbUsKcZbAhC2SIuU3QUNTVcX7uaZNasqmCnAjxAMMPawlW3GXj2wVX2pOIFhWx6rOcy+QTVkNLa7Eok9KpEmOdaJ9skMbnaoQ35QaWyLk5QIDAQAB

4 商户出口IP(可选)

如果贵公司服务器有固定的出口IP,可以在Web端配置IP白名单来加强通讯安全性。

测试环境: https://triplink.uat.ctripqa.com/webapp/yago/customer/apiConfig (opens new window)

生产环境: https://vcc.triplinkintl.com/webapp/yago/customer/apiConfig (opens new window)

ip_whitelist_config

TripLink固定出口IP如下:

环境 IP
测试(国内) 58.221.127.201
测试(海外) 45.251.106.248
45.251.106.249
生产(国内) 114.80.56.0 ~ 114.80.56.255114.80.56.0/24,共 256 IP)
211.95.54.0 ~ 211.95.54.255211.95.54.0/24,共 256 IP)
180.163.115.0 ~ 180.163.115.255180.163.115.0/24,共 256 IP)
220.196.164.0 ~ 220.196.164.255220.196.164.0/24,共 256 IP)
生产(海外) 103.48.141.160 ~ 103.48.141.191103.48.141.160/27,共 32 IP)
45.251.106.192 ~ 45.251.106.25545.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)
生产(国内 & 海外) 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 全局参数(可选)

您可以在Web端自主配置各种全局参数。

测试环境: https://triplink.uat.ctripqa.com/webapp/yago/customer/globalParmeter (opens new window)

生产环境: https://vcc.triplinkintl.com/webapp/yago/customer/globalParmeter (opens new window)

6 回调服务(可选)

如果贵公司需要使用授权结果通知授权决策回调服务,需要在Web端配置。

您可在此处查看,修改授权结果通知授权决策回调参数,以及提交历史。

如您提交的地址不在白名单中,会进入审批流程,审批通过后才会生效。(测试环境每小时刷新,生产环境每天凌晨1点刷新)

测试环境: https://triplink.uat.ctripqa.com/webapp/yago/customer/callbackParameter (opens new window)

生产环境: https://vcc.triplinkintl.com/webapp/yago/customer/callbackParameter (opens new window)

callback_config

授权通知地址:TripLink会在授权完成后以异步的方式发送授权结果至此客户接口。

通知开关:是否启用授权通知功能。(默认关闭)

授权决策地址:TripLink会批准授权请求之前回调此客户接口,客户可以以此实现自己的风控和授权决策。

决策开关:是否启用授权决策功能。(默认关闭)

降级策略:当授权决策接口超时或异常时,TripLink为客户使用的默认决策结果。(默认拒绝)

7 报表服务(可选)

如果贵公司需要通过SFTP来接收TripLink的报表文件,需要在Web端自主配置SFTP的IP白名单。

配置成功后会收到邮件通知,待TripLink审核通过后会再次发送邮件提供SFTP的登陆信息。

目前仅支持生产环境

生产环境: https://vcc.triplinkintl.com/webapp/yago/customer/sftpConfig (opens new window)

sftp_whitelist_config

未加密报表文件仅包含掩码卡号。如果需要16位明文卡号,请提供4096PGP公钥用于文件加密,可使用PGP密钥对生成器生成。

# 技术对接

贵公司可以自行基于API文档进行开发,也可以选择直接使用我们提供的SDK进行开发。

目前我们提供了Java和PHP版SDK,请参考客户端SDK

# 测试流程

在完成以上两步后贵公司可以开始进入测试流程,TripLink提供一个商户自助测试平台帮助您自助测试,通过这个平台您可以自助模拟各种类型的交易,请参考测试流程

# 生产发布

TripLink会和您一起检查测试过程中的日志。如果确认没有问题后,TripLink团队会帮助贵公司创建生产环境的商户账号,开通和配置生产环境的网络访问环境。贵公司在拿到生产环境的商户配置后可以发布生产进行生产验证。