1. Ecuador
PayPaga V2 API
  • API Overview
    • Introduction
    • API Reference
    • Environments
    • Payment methods
    • Errors
    • Standard Codes and Values
    • Transaction Status Definitions and Lifecycle
    • Assets
    • Authorization
    • Changelog
      • Format
    • Transactions Status Notification
      • Transactions Status Notification
      • How to verify callback signature
      • Signing public keys
  • OAuth2 Service
    • authenticate
    • 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 RappiPay
        • Colombia ReFacil
        • Colombia Susuerte
        • Colombia Western Union
      • Ecuador
        • Ecuador Banco Guayaquil
          POST
        • Ecuador Bank Transfer
          POST
        • Ecuador Bemovil
          POST
        • Ecuador Deuna
          POST
        • Ecuador Mi Negocio Efectivo
          POST
        • Ecuador Omniswitch
          POST
        • Ecuador RapiActivo
          POST
        • Ecuador Western Union
          POST
      • Guatemala
        • Guatemala Akisi Pronet
        • Guatemala BAM Efectivo
        • Guatemala BAM Transferencia
        • Guatemala Banco Industrial
      • 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
    • 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
      • PaymentMethod
      • ReturnUrls
      • Message
      • ValidationErrorDetail
      • ValidationErrorItem
  1. Ecuador

Ecuador Banco Guayaquil

Production
https://api.paypaga.com
Production
https://api.paypaga.com
POST
/v2/transactions/pay-in
⚠️ Prior authorization required: To enable this payment method, please contact your account manager before proceeding with the integration.

Channel

Bank Transfer

Required Fields

FieldDescriptionValidation
first_nameCustomer first nameLength >= 2 <= 50, RegEx ^\p{L}*(?:[ '-]\p{L}+)*$
last_nameCustomer last nameLength >= 2 <= 50, RegEx ^\p{L}*(?:[ '-]\p{L}+)*$
emailCustomer emailLength >= 5 <= 50, RegEx ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$
phoneCustomer phone numberLength = 10 or 12, RegEx ^(?:09\d{8}|5939\d{8})$
document_typeDocument typeSee document types listed below
document_numberDocument numberSee document types listed below

Document types

Document TypeDescriptiondocument_number validation
CICedula de Identidad10 digits including last digit checksum
RUCRegistro Único de Contribuyentes13 numeric digits with check digit validation based on taxpayer type
PPPassportMust be a valid Ecuadorian passport

Response Fields

FieldDescription
referencePayment code ("Código de pago") the payer must provide at Banco Guayaquil (via the Corporate Collections / Monnet Pagos flow) to complete the deposit — see Payment Instructions below.

Expiry

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

Payment Instructions

Steps to complete your payment.

  1. Log in to your Online/Virtual Banking or mobile app and go to Pay Services.
  2. Under Corporate Collections, search for Monnet Pagos and enter the payment code shown in the response.
  3. Select your preferred payment method and verify the amount.
  4. Enter your security code, confirm, and that's it — the transaction will be processed automatically.

Spanish:

  1. Inicia sesión en tu Banca Virtual o aplicación móvil y ve a Pagar Servicios.
  2. En Recaudaciones Empresariales, busca Monnet Pagos e ingresa el código de pago mostrado arriba.
  3. Selecciona tu método de pago preferido y verifica el monto.
  4. Ingresa tu código de seguridad, confirma y ¡listo!

Request

Authorization
or
Body Params application/jsonRequired

Examples

Responses

🟢201
application/json
Pay-in accepted.
Headers

Bodyapplication/json

🟠400ValidationAndBadRequestError
🔴500InternalError
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": "EC",
    "currency": "USD",
    "customer_ip": "120.29.48.92",
    "fields": {
        "document_number": "1710034065",
        "document_type": "CI",
        "email": "mail@mail.com",
        "first_name": "John",
        "last_name": "Doe",
        "phone": "0991234567"
    },
    "merchant_customer_id": "customer@email.com",
    "merchant_order_reference": "ORDER-2026-0001",
    "merchant_transaction_reference": "TRX-2026-0001",
    "payment_method": "banco_guayaquil",
    "return_urls": {
        "failure_url": "https://merchant.com/payment-failure",
        "success_url": "https://merchant.com/payment-success"
    }
}'
Response Response Example
201 - Ecuador Banco Guayaquil
{
    "expires_at": "2026-06-09T14:13:05.143073869Z",
    "instructions": {
        "reference": "11230573"
    },
    "payment_method_reference": "129930",
    "transaction_id": "20260205-1127-4678-8883-5e4868d33e4e"
}
Modified at 2026-09-07 15:29:13
Previous
Colombia Western Union
Next
Ecuador Bank Transfer
Built with