# 快速接入
接入方可以联系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)
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)
TripLink固定出口IP如下:
环境 | IP |
---|---|
测试(国内) | 58.221.127.201 |
测试(海外) | 45.251.106.248 45.251.106.249 |
生产(国内) | 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) |
生产(海外) | 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) |
生产(国内 & 海外) | 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)
授权通知地址:TripLink会在授权完成后以异步的方式发送授权结果至此客户接口。
通知开关:是否启用授权通知功能。(默认关闭)
授权决策地址:TripLink会批准授权请求之前回调此客户接口,客户可以以此实现自己的风控和授权决策。
决策开关:是否启用授权决策功能。(默认关闭)
降级策略:当授权决策接口超时或异常时,TripLink为客户使用的默认决策结果。(默认拒绝)
7 报表服务(可选)
如果贵公司需要通过SFTP来接收TripLink的报表文件,需要在Web端自主配置SFTP的IP白名单。
配置成功后会收到邮件通知,待TripLink审核通过后会再次发送邮件提供SFTP的登陆信息。
目前仅支持生产环境
生产环境: https://vcc.triplinkintl.com/webapp/yago/customer/sftpConfig (opens new window)
未加密报表文件仅包含掩码卡号。如果需要16
位明文卡号,请提供4096
位PGP
公钥用于文件加密,可使用PGP密钥对生成器生成。
# 技术对接
贵公司可以自行基于API文档进行开发,也可以选择直接使用我们提供的SDK进行开发。
目前我们提供了Java和PHP版SDK,请参考客户端SDK。
# 测试流程
在完成以上两步后贵公司可以开始进入测试流程,TripLink提供一个商户自助测试平台帮助您自助测试,通过这个平台您可以自助模拟各种类型的交易,请参考测试流程。
# 生产发布
TripLink会和您一起检查测试过程中的日志。如果确认没有问题后,TripLink团队会帮助贵公司创建生产环境的商户账号,开通和配置生产环境的网络访问环境。贵公司在拿到生产环境的商户配置后可以发布生产进行生产验证。