1. Guatemala
PayPaga V2 API
  • API Overview
    • Introduction
    • API Reference
    • Environments
    • Payment methods
    • Errors
    • Standard Codes and Values
    • Transaction Status Definitions and Lifecycle
    • Assets
    • Authorization
    • Changelog
      • Changelog
      • Format
    • Transactions Status Notification
      • Transactions Status Notification
      • How to verify callback signature
      • Signing public keys
  • OAuth2 Service
    • Authorization
    • OAuth 2.0 Token Generation
    • Schemas
      • AuthRequest
      • AuthResponse
      • AuthFailed
  • PayPaga Integration API
    • Transactions Configuration
      • List available pay-in configurations.
      • List available pay-out configurations.
    • Pay-in Transactions
      • Search pay-in transactions
      • Create a pay-in transaction.
      • Retrieve a pay-in transaction.
    • Development Utilities
      • Override a pay-in transaction status
      • Override a pay-out transaction status
    • Pay-out Transactions
      • Search pay-out transactions
      • Create a pay-out transaction.
      • Retrieve a pay-out transaction.
    • Pay URLs
      • Create a hosted PayURL checkout
    • Balances
      • Retrieve merchant balance summary.
    • Catalog
      • List supported countries
      • List supported payment methods
    • Settlements
      • Search settlements
      • Retrieve settlement transactions
      • Retrieve settlement options
    • Reference Data
      • Retrieve exchange rates
      • Retrieve tax rates
    • Notifications
      • List notification subscriptions
      • Create a notification subscription
      • Retrieve a notification subscription
      • Delete a notification subscription
    • Schemas
      • MoneyAmount
      • Currency
      • Country
      • PayOutTransaction
      • CreatePayURLRequest
      • PredefinedFields
      • PayOutTransactionStatusOverrideRequest
      • CreatePayOutResponse
      • ReturnUrls
      • CreatePayOutRequest
      • TaxRate
      • PaymentInstructions
      • PayInTransactionStatusOverrideRequest
      • CreatePayInRequest
      • CreatePayInResponse
      • CreatePayURLResponse
      • BalanceTotal
      • BalanceCountry
      • BalanceSummaryResponse
      • TransactionCallbackPayload
      • PaymentMethodCatalogEntry
      • Settlement
      • NotificationSubscriptionRequest
      • SettlementWindow
      • SettlementOptionsResponse
      • SettlementTransaction
      • ListNotificationSubscriptionsResponse
      • NotificationSubscriptionResponse
      • ExchangeRatesResponse
      • PayInTransaction
      • ValidationErrorDetail
      • ValidationErrorItem
      • PaymentOption
      • PaymentMethod
      • OptionField
      • Product
      • PayInTransactionStatus
      • PayOutTransactionStatus
      • NotificationType
      • PaginationMeta
      • MerchantOrderReference
      • MerchantTransactionReference
      • FeeMode
      • Code
      • Message
      • ErrorDetail
      • PayInTransactionListResponse
      • Money
      • PayOutTransactionListResponse
      • CountryCatalogEntry
      • SettlementsResponse
      • SettlementTransactionsResponse
      • ExchangeRateQuote
      • ChannelType
  • Examples
    • Pay In Examples
      • Argentina
        • Argentina Instant Transfer
      • Bolivia
        • Bolivia Qr Interoperable
      • Brazil
        • Brazil PIX
      • Chile
        • Chile Bank Transfer
        • Chile Khipu
      • Colombia
        • Colombia Dale
        • Colombia Daviplata
        • Colombia Efecty
        • Colombia Gana
        • Colombia Movii
        • Colombia Nequi
        • Colombia PSE
        • Colombia Puntored
        • Colombia RappiPay
        • Colombia ReFacil
        • Colombia Susuerte
        • Colombia Western Union
      • Ecuador
        • Ecuador Bank Transfer
        • Ecuador Bemovil
        • Ecuador Deuna
        • Ecuador Mi Negocio Efectivo
        • Ecuador Omniswitch
        • Ecuador RapiActivo
        • Ecuador Western Union
      • Guatemala
        • Guatemala Akisi Pronet
          POST
        • Guatemala BAM Efectivo
          POST
        • Guatemala BAM Transferencia
          POST
        • Guatemala Banco Industrial
          POST
        • Guatemala Cash Voucher
          POST
      • Honduras
        • Honduras Cash Voucher
        • Honduras Digital Voucher
      • Mexico
        • Mexico Pay With Cash
        • Mexico SPEI
      • Peru
        • Peru BBVA
        • Peru BCP
        • Peru BCP Efectivo
        • Peru Cell Power
        • Peru KasNet
        • Peru Plin
        • Peru QR Interoperable
        • Peru Yape
      • Costa Rica
        • Costa Rica Cash Voucher
        • Costa Rica Digital Voucher
      • Panama
        • Panama Cash Voucher
        • Panama Digital Voucher
      • Dominican Republic
        • Dominican Republic Cash Voucher
    • Pay Out Examples
      • Argentina
        • Argentina Instant Transfer
      • Bolivia
        • Bolivia Bank Transfer
      • Brazil
        • Brazil PIX
      • Chile
        • Chile Bank Transfer
      • Colombia
        • Colombia Bank Transfer
      • Ecuador
        • Ecuador Bank Transfer
      • Guatemala
        • Guatemala Bank Transfer
      • Mexico
        • Mexico SPEI
      • Peru
        • Peru Bank Transfer
    • Schemas
      • Pay In
        • Country
        • Currency
        • PaymentMethod
        • MerchantOrderReference
        • MerchantTransactionReference
        • ReturnUrls
        • CreatePayInRequest
        • PaymentInstructions
        • CreatePayInResponse
      • Country
      • Code
      • CreatePayInRequest
      • Currency
      • CreatePayInResponse
      • CreatePayOutRequest
      • CreatePayOutResponse
      • MerchantTransactionReference
      • MerchantOrderReference
      • ErrorDetail
      • PaymentInstructions
      • ReturnUrls
      • Message
      • PaymentMethod
      • ValidationErrorDetail
      • ValidationErrorItem
  1. Guatemala

Guatemala Cash Voucher

Production
https://api.paypaga.com
Production
https://api.paypaga.com
POST
/v2/transactions/pay-in

Channel#

Cash

Optional Fields#

FieldDescriptionValidation
networkPayment point network. If omitted, a generic cash payment point can be used.See network code values below

Networks#

NameCodeMinimum amountMaximum amount
FarmaCostofarmacosto20 GTQ3,000 GTQ
Airpakairpak20 GTQ10,000 GTQ
Super 24super_2420 GTQ8,000 GTQ
Akisi Pronetakisi_pronet20 GTQ10,000 GTQ
Super 24 and Akisi Pronet only accept fixed payment amounts; Super 24 also applies an additional end-user surcharge (3.00 GTQ Monday–Friday, 5.00 GTQ Saturday–Sunday, extended hours on the 15th and last day of each month at the same rate).

Expiry#

Initiated transactions that are not completed, transition to an Expired state after 72 hours.

Payment Instructions#

Network not specified (generic)
1.
Go to any of the following payment points: FarmaCosto, Airpak, Super 24, or any Akisi Pronet point (FarmaPrecio, Multicambios y Servicios, Forza Delivery, Cooperativa Cooitza, Crediguate, Fafidess, Cooperativa de Ahorro y Créditos Concepción R.L., Cooperativa Con Pisco S.A., Cooperativa Cooper R.L., Cooperativa Mi Esperanza, Coop. Cointec R.L.).
2.
Tell the cashier you want to make a PayCash payment.
3.
Provide the 16-digit reference and the amount to pay.
4.
Receive your payment receipt.
FarmaCosto
1.
Locate your nearest branch.
2.
Provide your ID document number.
3.
Ask the cashier to process a PayCash payment.
4.
Provide the 16-digit reference number and amount.
5.
Confirm the amount and hand the cash to the cashier.
6.
Receive your payment receipt.
Airpak
1.
Go to an Airpak point.
2.
Ask the cashier to process a PayCash payment.
3.
Provide the 16-digit reference and the amount to pay.
4.
Receive your payment receipt.
Super 24
1.
Ask the cashier to process an Akisi - PayCash payment.
2.
Provide the 16-digit reference and the amount to pay.
3.
Receive your payment receipt.
4.
Note: fixed amounts only.
5.
Note: an additional end-user surcharge applies at Super 24 — 3.00 GTQ Monday to Friday, 5.00 GTQ Saturday and Sunday, any time. On the 15th and last day of each month, extended hours apply until 21:00 at the same rate.
Akisi Pronet
1.
Ask the cashier at FarmaPrecio, Multicambios y Servicios, Forza Delivery, Cooperativa Cooitza, Crediguate, Fafidess, Cooperativa de Ahorro y Créditos Concepción R.L., Cooperativa Con Pisco S.A., Cooperativa Cooper R.L., Cooperativa Mi Esperanza, or Coop. Cointec R.L. to process a PayCash payment.
2.
Provide the 16-digit reference and the amount to pay.
3.
Receive your payment receipt.
4.
Note: fixed amounts only.
The response does not include step-by-step instructions or the selected network; use payment_method_reference (the 16-digit PayCash reference) as the reference number to share with the cashier.

Request

Authorization
or
Body Params application/jsonRequired

Examples

Responses

🟢201
application/json
Pay-in accepted.
Headers

Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.paypaga.com/v2/transactions/pay-in' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": 1000,
    "country": "GT",
    "currency": "GTQ",
    "customer_ip": "120.29.48.92",
    "fields": {
        "network": "farmacosto"
    },
    "merchant_customer_id": "customer@email.com",
    "merchant_order_reference": "ORDER-2026-0029",
    "merchant_transaction_reference": "TRX-2026-0029",
    "payment_method": "cash_voucher",
    "return_urls": {
        "failure_url": "https://merchant.com/payment-failure",
        "success_url": "https://merchant.com/payment-success"
    }
}'
Response Response Example
{
    "expires_at": "2026-06-12T09:22:00Z",
    "instructions": {},
    "payment_method_reference": "7041621293386803",
    "transaction_id": "20260210-1142-4b91-9c04-6e5979d44f03"
}
Modified at 2026-10-19 14:08:05
Previous
Guatemala Banco Industrial
Next
Honduras Cash Voucher
Built with