Trustly

​

How a Trustly payment works

1. The customer selects Trustly at checkout.
2. Payrails returns a redirect URL from Worldpay, and the customer goes to Trustly.
3. The customer confirms the payment with their bank.
4. Trustly sends the customer back to your returnInfo URL.
5. Payrails receives the final result from Worldpay and updates the payment.

​

Supported currencies and countries

​

Supported workflows

​

Before you begin

1. Set up a Worldpay integration in your workspace. Contact your Payrails account team if Worldpay isn’t listed in your Payrails Portal yet.
2. Ask Worldpay to enable Trustly on your Worldpay entity.
3. In the Payrails Portal, go to Settings → Integrations, open your Worldpay integration, select Trustly under Payment methods, and save.
4. Add Trustly as a payment option in your workflow.

​

Request fields for Worldpay

​

Authorize a Trustly payment

{
  "amount": {
    "value": "25.00",
    "currency": "EUR"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "trustly",
      "amount": {
        "value": "25.00",
        "currency": "EUR"
      }
    }
  ],
  "meta": {
    "order": {
      "reference": "order-1234",
      "softDescriptor": "Example Store",
      "billingAddress": {
        "email": "astrid.lindqvist@example.com",
        "country": {
          "code": "SE"
        }
      }
    }
  },
  "returnInfo": {
    "success": "https://example.com/success",
    "error": "https://example.com/error"
  }
}

​

How Worldpay handles Trustly

• Payrails reads the customer’s email from meta.order.billingAddress.email, not from meta.customer.email.
• When Worldpay reports the payment as pending after the redirect, Payrails waits for the Worldpay webhook to set the final status.
• Save Instruments and merchant-initiated transactions (MIT) aren’t available for Trustly through Worldpay.