SafetyPay via Worldpay

​

Supported workflows

​

Before you begin

1. Set up a Worldpay integration in your workspace. Follow the Worldpay integration setup guide if you don’t have one 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.
• Each SafetyPay payment is a new customer-initiated payment.