dLocal - Servipag

Configure Servipag via dLocal as a payment method in Gr4vy.

dLocal is a global payments platform that helps you accept local payment methods and cards across emerging markets.

Servipag is a payment service in Chile that enables consumers to make cash and online payments through a network of locations.

Setup

Please follow the common dLocal instructions to get set up with Servipag.

Next, make sure to enable Servipag as a payment method on your configured account.

Capabilities

Supported countries

Supported currencies

Integration

For Servipag, the default integration is through a redirect to a hosted payments page.

Start by creating a new transaction with the following required fields.

C#

var transaction = await client.Transactions.CreateAsync(
    transactionCreate: new TransactionCreate()
    {
        Amount = 1299,
        Currency = "CLP",
        Country = "CL",
        PaymentMethod =
            TransactionCreatePaymentMethod.CreateRedirectPaymentMethodCreate(
                new RedirectPaymentMethodCreate()
                {
                    Method = "servipag",
                    Country = "CL",
                    Currency = "CLP",
                    RedirectUrl = "https://example.com/callback",
                }
            ),
    }
);

amount := int64(1299)
currency := "CLP"
country := "CL"
method := components.RedirectPaymentMethodCreateMethodServipag
redirectUrl := "https://example.com/callback"

redirectPaymentMethodCreate := components.RedirectPaymentMethodCreate{
    Method: method,
    Country: country,
    Currency: currency,
    RedirectURL: redirectUrl,
}
paymentMethod := components.CreateTransactionCreatePaymentMethodRedirectPaymentMethodCreate(redirectPaymentMethodCreate)

transactionCreate := components.TransactionCreate{
    Amount:        amount,
    Currency:      currency,
    Country:       &country,
    PaymentMethod: &paymentMethod,
}

transaction, err := client.Transactions.Create(ctx, transactionCreate, nil, nil, nil)

CreateTransactionResponse transactionResponse = gr4vyClient.transactions().create()
    .transactionCreate(TransactionCreate.builder()
        .amount(1299L)
        .currency("CLP")
        .country("CL")
        .paymentMethod(TransactionCreatePaymentMethod.of(RedirectPaymentMethodCreate.builder()
            .method(RedirectPaymentMethodCreateMethod.SERVIPAG)
            .country("CL")
            .currency("CLP")
            .redirectUrl("https://example.com/callback")
            .build()))
        .build())
    .call();

Transaction transaction = transactionResponse.transaction().orElse(null);

$transactionCreate = new TransactionCreate(
    amount: 1299,
    currency: 'CLP',
    country: 'CL',
    paymentMethod: new RedirectPaymentMethodCreate(
        method: 'servipag',
        country: 'CL',
        currency: 'CLP',
        redirectUrl: 'https://example.com/callback'
    )
);
$response = self::$sdk->transactions->create($transactionCreate);
$transaction = $response->transaction;

transaction: models.Transaction = client.transactions.create(
    amount=1299,
    currency="CLP",
    country="CL",
    payment_method={
        "method": "servipag",
        "country": "CL",
        "currency": "CLP",
        "redirect_url": "https://example.com/callback",
    }
)

const transaction = await gr4vy.transactions.create({
    amount: 1299,
    currency: "CLP",
    country: "CL",
    paymentMethod: {
        method: "servipag",
        country: "CL",
        currency: "CLP",
        redirectUrl: "https://example.com/callback"
    }
})

After the transaction is created, the API response includes payment_method.approval_url and the status is set to processing.

Redirect the buyer to the approval_url so they can complete the payment. After approval the buyer is redirected to the redirect_url you provided when creating the transaction. Do not rely solely on the redirect - either poll the transaction or (recommended) rely on webhooks to detect the final status (for example capture_succeeded or failure states).