SafetyPay

​

How a SafetyPay payment works

1. The customer selects SafetyPay at checkout.
2. Payrails returns a redirect URL from Worldpay, and the customer goes to SafetyPay.
3. The customer confirms the payment with SafetyPay.
4. SafetyPay 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 SafetyPay on your Worldpay entity.
3. In the Payrails Portal, go to Settings → Integrations, open your Worldpay integration, select SafetyPay under Payment methods, and save.
4. Add SafetyPay as a payment option in your workflow.

​

Request fields for Worldpay

​

Authorize a SafetyPay payment

{
  "amount": {
    "value": "25.00",
    "currency": "USD"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "safetyPay",
      "amount": {
        "value": "25.00",
        "currency": "USD"
      }
    }
  ],
  "meta": {
    "order": {
      "reference": "order-1234",
      "softDescriptor": "Example Store",
      "billingAddress": {
        "email": "lucia.quispe@example.com",
        "country": {
          "code": "PE"
        }
      }
    }
  },
  "returnInfo": {
    "success": "https://example.com/success",
    "error": "https://example.com/error"
  }
}

​

How Worldpay handles SafetyPay

• Worldpay doesn’t add a payment status to the return URL for SafetyPay. Payrails reads the result from the return path instead: success, pending, or cancel.
• When the customer returns with a pending result, Payrails doesn’t wait on the redirect. The Worldpay webhook sets the final status.
• Payrails reads the customer’s email from meta.order.billingAddress.email, not from meta.customer.email. Payrails doesn’t send the customer’s name for SafetyPay.
• Save Instruments and merchant-initiated transactions (MIT) aren’t available for SafetyPay through Worldpay.