Skip to main content
Multipago is a wallet payment provider in Bolivia that supports credit cards, QR payments, and bank transfers. Multipago uses a redirect flow where the buyer completes the payment on the Multipago hosted page.

Setup

Multipago does not provide self-service sign-up. Contact the Multipago support team to create an account.

Credentials

When setting up Multipago in the dashboard, configure the following credentials:
  • Provider - The merchant account ID, formatted as a short human-readable string.
  • UID - The account key, formatted as a random string.
Contact your Multipago representative for these details.

Capabilities

Supported countries

Supported currencies

Required fields

Multipago requires the following buyer information with every transaction:
  • First name
  • Last name
  • Email address
  • Phone number
  • Tax ID

Webhooks

Multipago requires webhook setup to receive transaction status updates. Contact Multipago to configure the webhook URL for your account.

Integration

The default integration for Multipago uses a redirect to a hosted payments page. Start by creating a new transaction with the following required fields.
var transaction = await client.Transactions.CreateAsync(
  transactionCreate: new TransactionCreate()
  {
    Amount = 1299,
    Currency = "BOB",
    Country = "BO",
    PaymentMethod =
      TransactionCreatePaymentMethod.CreateRedirectPaymentMethodCreate(
        new RedirectPaymentMethodCreate()
        {
          Method = "multipago",
          Country = "BO",
          Currency = "BOB",
          RedirectUrl = "https://example.com/callback",
        }
      ),
  }
);
amount := int64(1299)
currency := "BOB"
country := "BO"
method := components.RedirectPaymentMethodCreateMethodMultipago
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("BOB")
    .country("BO")
    .paymentMethod(TransactionCreatePaymentMethod.of(RedirectPaymentMethodCreate.builder()
      .method(RedirectPaymentMethodCreateMethod.MULTIPAGO)
      .country("BO")
      .currency("BOB")
      .redirectUrl("https://example.com/callback")
      .build()))
    .build())
  .call();

Transaction transaction = transactionResponse.transaction().orElse(null);
$transactionCreate = new TransactionCreate(
  amount: 1299,
  currency: 'BOB',
  country: 'BO',
  paymentMethod: new RedirectPaymentMethodCreate(
    method: 'multipago',
    country: 'BO',
    currency: 'BOB',
    redirectUrl: 'https://example.com/callback'
  )
);
$response = $client->transactions->create($transactionCreate);
$transaction = $response->transaction;
transaction: models.Transaction = client.transactions.create(
  amount=1299,
  currency="BOB",
  country="BO",
  payment_method={
    "method": "multipago",
    "country": "BO",
    "currency": "BOB",
    "redirect_url": "https://example.com/callback",
  }
)
const transaction = await client.transactions.create({
  amount: 1299,
  currency: "BOB",
  country: "BO",
  paymentMethod: {
    method: "multipago",
    country: "BO",
    currency: "BOB",
    redirectUrl: "https://example.com/callback"
  }
})
After the transaction is created, the API response includes a payment_method.approval_url and the status is set to buyer_approval_pending. The approval URL expires after 30 minutes.
{
  "type": "transaction",
  "id": "ea1efdd0-20f9-44d9-9b0b-0a3d71e9b625",
  "payment_method": {
    "type": "payment-method",
    "approval_url": "https://cdn.gr4vy.com/connectors/..."
  },
  "method": "multipago"
}
Redirect the buyer to the approval_url (open in a browser or Webview), where they can complete the payment. Once the buyer completes the payment, the transaction progresses to a capture_succeeded state.