Skip to main content
Migo Docs

What are Alternative Payments?

Alternative Payment Methods (APMs) are every way a customer can pay you that isn't a credit or debit card. In Guatemala they include digital wallets like Zigi or Akisi, interbank QR codes such as Banco Industrial or QuickPay QR, hosted bank buttons like BAM PaymentButton, and cash references payable at convenience stores like Pronet.

You don't need to integrate each rail separately. Migo exposes one set of endpoints that route to the supported wallets, banks, and cash networks; the merchant chooses which ones to enable per country.

Alternative payments are an asynchronous checkout: you create a transaction, the customer pays in an external rail, and Migo confirms the result before you treat the order as paid. The end-to-end lifecycle is in How it works.

How APMs differ from card payments​

AspectCard paymentsAlternative payments
Authentication3DS / CVV / token in your checkoutCustomer's banking app, wallet, or QR scanner
AuthorizationSynchronous β€” you get APPROVED in the responseAsynchronous β€” confirmed later by a processor webhook
SettlementCaptured at authorizationSettled once the customer authorizes outside your app
Required dataA card tokenMethod-specific payload (phone, bank id, document, voucher)
Failure modesNetwork, 3DS challenge, declineCustomer abandons, QR expires, bank rejects push

The four endpoints​

Every APM integration uses only four endpoints β€” the same shape regardless of which method the customer picks:

EndpointWhat it does
POST /api/v1/integrations/transactionsCreates the transaction and returns the methods available for that merchant.
POST /api/v1/integrations/transactions/{id}/payment-intents(Optional) Fetches dynamic metadata for the methods that need it. Most Guatemala rails don't require it; in sandbox, fri returns a user fixture you can use to simulate an authorization.
POST /api/v1/integrations/transactions/{id}/paymentsSubmits the chosen method and any user-collected data. Returns the rail-specific payload to render.
POST /api/v1/integrations/transactions/{id}/dismissCancels an unpaid or expired transaction so the merchant can recover its UI.

All calls require Authorization: Bearer <token>.