WebPay via Transbank

​

Supported workflows

​

Before you begin

1. Set up a Transbank integration in your workspace. Follow the Transbank integration setup guide if you don’t have one yet.
2. In the Payrails Portal, go to Settings → Integrations, open your Transbank integration, select WebPay under Payment methods, and save.
3. To capture payments later, ask Transbank for a commerce code set up for deferred capture, and turn on Manual capture enabled on your Transbank integration.
4. Add WebPay as a payment option in your workflow.

​

Request fields for Transbank

​

Authorize a WebPay payment

{
  "amount": {
    "value": "12000",
    "currency": "CLP"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "webPay",
      "amount": {
        "value": "12000",
        "currency": "CLP"
      }
    }
  ],
  "returnInfo": {
    "success": "https://example.com/success",
    "error": "https://example.com/error"
  }
}

​

How Transbank handles WebPay

• Transbank sends no notifications. Payrails confirms the payment with Transbank when the customer comes back from the WebPay Plus page. If the customer cancels on that page, Payrails marks the payment as canceled by the payer.
• With a deferred-capture commerce code and Manual capture enabled, Payrails authorizes the payment, and you capture it later. Otherwise, Transbank captures the payment when the customer confirms it.
• Cancel and refund both use the Transbank refund endpoint. Transbank reverses a payment that hasn’t settled yet in full, and refunds a settled payment against its balance.