# Service launch and technology integration

In order to use the Tenpay Global checkout service, merchants need to complete the global kiosk service launch and technology integration

# Service opens

It consists of two steps, both of which need to be completed on the Weixin Mini Program Official Management Platform . For detailed opening guidance, see the Tenpay Global Opening Handbook :

  • Global Cashier Function Opening: Submit information about corporate entities, beneficiaries, business contacts and other information to Tenpay Global, and pass the material review to open the global cashier service as a whole
  • Payment method activation: According to the payment method selected by the merchant, add settlement bank account, business questionnaire and other information to activate the selected payment method

# Technology Integration Guidelines

The following describes the main integration content and steps of the Tenpay Global Checkout Service. For detailed developer guidance, please refer to Tenpay Global Checkout API Dxplaination and Integration Guidance

# Interface composition

  • Tenpay Global interface: For details, see Interface Description
    Interface Name Call chains Method Interface Address
    Pay pre-order Merchants - > Tenpay Global POST /api/payment/v1/checkout-pay
    Enquire about the payment slip Merchants - > Tenpay Global POST /api/payment/v1/inquiry-payment
    Close Orders Merchants - > Tenpay Global POST /api/payment/v1/close-payment
    Request a refund Merchants - > Tenpay Global POST /api/payment/v1/refund
    Check out the refund form Merchants - > Tenpay Global POST /api/payment/v1/inquiry-refund
    Notification of Payment Results (WebHook) Tenpay Global- > Merchants POST Specified by the notify_url of checkout-pay
    Notification of Refund Results (WebHook) Tenpay Global- > Merchants POST Specified by notify_url of refund
  • Weixin Mini Program Interface / Object: See Mini Program Tenpay Global Checkout Object for details
    Interface / Object Name Introductions
    wx.createGlobalPayment Create a Tenpay Global Checkout object
    globalPayment.openMethodPicker Pull up the payment method selection panel
    globalPayment.requestGlobalPayment Go to the payment page at the Tenpay Global Checkout
    globalPayment.methodKey Selected payment method

# Sub-scenario integration

For guidance on integration for different application scenarios such as payments, refunds, closure of orders, query payment forms, inquiry refund forms, and receiving Tenpay Global notifications, see technology integration guidance

# Participant Relationships

4

# Development steps

Step 1: Service Opening

Log in Weixin Mini Program Official Management Platform , enter the "global cashier" and complete the service opening.Please refer to TenpayGlobal's Tenpay Global Checkout Service Introduction Manual

After the opening, enter the "Settings" module to upload the merchant API certificate & get the Tenpay Global platform certificate to complete the follow-up interface verification.

Step 2: Development

Development Weixin Mini Program front-end pull up the cashier function, development of background interface

Step3: Verification

Validation in a UAT environment and finally migration to production validation

Step4: Volume

Once the validation is complete, turn on the customer volume

In case of problems during the development process, contact Tenpay Global's Tenpay Global Checkout team for technical support

# Environmental Information

# UAT Environment

https://uat.tenpayglobal.com

E.g.: checkout-pay interface UAT domain name https://uat.tenpayglobal.com/api/payment/v1/checkout-pay

# Production environment

Once the merchant has successfully settled in, configured the key, and opened the payment method, it can be verified using the formal production environment. Please contact the Global Cashier Team at Tenpay Global for specific address.

# FAQ

Q: For notification interface, does the merchant need to check the signature?

A: Yes, you need to check and sign at any time to ensure that the information obtained is from the official and legal information