Integration guide for Travel
Provide Trustly as a payment method in your checkout process to your travel service customers.
Trustly's travel services integrations cover the following scenarios:
Customers pay all at once.
Accept recurring payments from customers with a Payment plan where a deposit is paid for a travel product and the remainder is accepted in instalments.
Note: Currently, recurring payments can only be accepted in Sweden.
Provide a Refund.
API methods and notifications to implement in your travel service system are shown in the following table:
API method/notification | Function | Purpose |
---|---|---|
Deposit | Pay-in | Customers pay with Trustly at checkout |
Refund | Refund | Provide refunds to customers |
Charge CancelCharge | Recurring payment | Customers make recurring payments via Trustly. Used together with Deposit or SelectAccount |
SelectAccount | Bank account tokenisation | Registers customers |
Pending notification | Notification | You’re notified when the checkout flow is completed successfully |
Cancel notification | Notification | You’re notified when the checkout flow has been interrupted |
Credit notification | Notification | You’re notified when the checkout is completed successfully |
Debit notification | Notification | You’re notified when the checkout fails |
Account notification | Notification (Optional) | Trustly sends information about the account used in this order |
Build integration for travelling customers to pay for their travels
Make sure that you have completed Sign up and received a Trustly test account.
If you have a native app implementation, integrate Trustly SDKs.
In a typical Deposit flow:
Your customer enters the amount for payment in your checkout.
Your system sends an API call to
Deposit
.Trustly responds with a checkout URL and
OrderID
.Your system redirects the customer to the Trustly checkout where they log in to their bank and authorise the payment.
The customer will be redirected from the Trustly checkout to
SuccessURL
specified in the deposit API call.Depending on the outcome, Trustly may send these notifications:
Cancel notification if the checkout process is interrupted.
Pending notification when the customer has completed the checkout process.
Account notification Trustly sends information about the bank account used in this order.
Credit notification when the payment has arrived at your Trustly account.
Debit notification if the transaction fails after the credit notification is sent.
Your system responds to the received notifications.
Note: Account, Pending, Credit notifications can arrive in any order. The Account notification is not enabled by default. Contact Trustly Integration Support, if you need it.
Develop business logic according to the deposit flow.
Make sure that your integration follows security requirements. See Security.
When a customer chooses Trustly in your checkout, your system calls Deposit.
Integrate Trustly Express. See Trustly Express API.
When Trustly responds with a Trustly URL, your system presents the URL to the customer to select a bank for making the deposit.
Make sure that your integration logs and handles error codes that are returned from API calls. See Error handling.
Make sure that your integration responds correctly to notifications that Trustly may send out.
When your integration presents a Trustly URL to customers, the presentation must follow Trustly checkout guidelines.
Prior to going live, the Trustly Integration Specialist will perform Acceptance testing. Make sure your integration has passed all test cases, including:
Deposit API calls
Built-in test cases of acceptance testing: D1 to D5, and G1 to G3.
Verify that your app has correct responses to notifications. See Notification tool.
Follow the instructions to go live.
Build integration to refund travelling customers
Make sure that you have completed Sign up and received a Trustly test account.
If you have a native app implementation, integrate Trustly SDKs.
In a typical Refund flow:
Your system sends an API call to Refund.
Trustly responds with
"result" : "1"
to acknowledge the call is received.Trustly checks whether the funds have been settled.
If the funds are not settled, Trustly will process the refund request when the funds are settled.
If the funds are settled, Trustly will process the refund request.
Trustly sends a Payout confirmation when the funds are successfully sent from Trustly.
Note: The Payout confirmation is not enabled by default. Contact Trustly Integration Support, if you need it.If the refund fails, Trustly will send a Credit notification.
Your system responds to the received notifications.
Develop business logic according to the charge flow.
Make sure that your integration follows security requirements. See Security.
Make sure that you have sufficient funds in your Trustly account. You can schedule API call to Balance to ensure that your balance is sufficient.
When a customer requests a refund, you system sends a call to Refund.
Make sure that your integration logs and handles error codes that are returned from API calls. See Error handling.
Make sure that your integration responds correctly to Trustly notifications.
When your integration presents a Trustly URL to customers, the presentation must follow Trustly checkout guidelines.
Prior to going live, the Trustly Integration Specialist will perform Acceptance testing. Make sure your integration has passed all test cases, including:
Deposit API calls
Built-in test cases of acceptance testing: D1 to D5, and G1 to G3
Verify that your integration has correct responses to notifications. See Notification tool.
Follow the instructions to go live.