1. Pay-in Transactions
PayPaga V2 API
  • API Overview
    • Introduction
    • API Reference
    • Environments
    • Payment methods
    • Errors
    • Standard Codes and Values
    • Transaction Status Definitions and Lifecycle
    • Changelog
      • Format
  • OAuth2 Service
    • authenticate
      POST
    • 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
        GET
      • Create a pay-in transaction.
        POST
      • Retrieve a pay-in transaction.
        GET
    • 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 options
      • Retrieve settlement transactions
    • Reference Data
      • Retrieve exchange rates
      • Retrieve tax rates
    • Notifications
      • Create a notification subscription
      • List notification subscriptions
      • Retrieve a notification subscription
      • Delete a notification subscription
    • Schemas
      • MoneyAmount
      • Currency
      • Country
      • PaymentMethod
      • Product
      • OptionField
      • PayInTransactionStatus
      • PayOutTransactionStatus
      • NotificationType
      • PaginationMeta
      • MerchantOrderReference
      • MerchantTransactionReference
      • FeeMode
      • PaymentOption
      • Code
      • Message
      • ValidationErrorItem
      • ValidationErrorDetail
      • ErrorDetail
      • PayInTransaction
      • PayInTransactionListResponse
      • ReturnUrls
      • CreatePayInRequest
      • PaymentInstructions
      • CreatePayInResponse
      • PayInTransactionStatusOverrideRequest
      • PayOutTransaction
      • PayOutTransactionListResponse
      • CreatePayOutRequest
      • CreatePayOutResponse
      • PayOutTransactionStatusOverrideRequest
      • PredefinedFields
      • CreatePayURLRequest
      • CreatePayURLResponse
      • BalanceTotal
      • BalanceCountry
      • BalanceSummaryResponse
      • CountryCatalogEntry
      • PaymentMethodCatalogEntry
      • Settlement
      • SettlementsResponse
      • SettlementWindow
      • SettlementOptionsResponse
      • SettlementTransaction
      • SettlementTransactionsResponse
      • ExchangeRateQuote
      • ExchangeRatesResponse
      • TaxRate
      • ChannelType
      • NotificationSubscriptionResponse
      • ListNotificationSubscriptionsResponse
      • NotificationSubscriptionRequest
      • TransactionCallbackPayload
  • Examples
    • Pay In Examples
      • Argentina
        • Argentina CVU
      • 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 Bank Transfer
        • Ecuador Banco Guayaquil
        • Ecuador Bemovil
        • Ecuador Deuna
        • Ecuador Mi Negocio Efectivo
        • Ecuador Omniswitch
        • Ecuador RapiActivo
        • Ecuador Western Union
      • Guatemala
        • Guatemala BAM Efectivo
        • Guatemala BAM Transferencia
        • Guatemala Banco Industrial
        • Guatemala Akisi Pronet
      • Mexico
        • Mexico Pay With Cash
        • Mexico SPEI
      • Peru
        • Peru BBVA
        • Peru BCP
        • Peru BCP Efectivo
        • Peru Cell Power
        • Peru KasNet
        • Peru QR Interoperable
        • Peru Plin
        • Peru Yape
    • Pay Out Examples
      • Argentina
        • Argentina CVU
      • 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
      • CreatePayOutRequest
      • ReturnUrls
      • CreatePayInRequest
      • CreatePayOutResponse
      • PaymentInstructions
      • CreatePayInResponse
  1. Pay-in Transactions

Create a pay-in transaction.

Production
https://api.paypaga.com
Production
https://api.paypaga.com
POST
/v2/transactions/pay-in
Method initiates a new pay-in transaction for the merchant and returns its details.

Typical Flow:#

1.
Create a pay-in transaction
2.
Present payment instructions to customer
3.
Monitor transaction status via callbacks or polling Get Pay-in Transaction endpoint.
4.
Handle approved/failed states accordingly
Executes a Pay In payment transaction, indicating the selected payment method and supplying any payment method specific data.
Required fields by country and payment method (details and definitions provided in the List available pay-in configurations)
Request bodies and responses for different payment methods can be found in the examples section of this endpoint.
All Pay In transactions where asynchronous end user interaction is required will transition to an Expired status if the payment remains in a Pending status after a time limit.
To check the current status of a transaction, use the Get Pay-in Transaction endpoint.
A transaction in Initiated state where no Payment Method has been selected will transition to an Expired status after 96 hours. A notification will be sent when a transaction has expired as described in Transactions Status Notification.

Error codes for Pay-in Payment Processing#

HTTP statusError codeDescription
400BAD_REQUESTFailed to parse the request body
400VALIDATION_ERRORRequest validation failed
401UNAUTHORIZEDMissing or invalid authorization token
409MERCHANT_REFERENCE_ALREADY_EXISTSMerchant transaction reference already exists
500INTERNAL_ERRORUnexpected server error

Request

Authorization
OAuth 2.0
Client Credentials
Add the parameter
Authorization
to Headers
,whose value is to concatenate the Token after the Bearer.
Example:
Authorization: Bearer ********************
Token URL: https://api.paypaga.com/oauth2/token
or
Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201
application/json
Pay-in accepted.
Headers

Bodyapplication/json

🟠400ValidationAndBadRequestError
🟠401Unauthorized
🟠409DuplicateMerchantReference
🔴500InternalError
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://api.paypaga.com/v2/transactions/pay-in' \
--header 'DisablePartnerMock;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": 1000,
    "country": "AR",
    "currency": "ARS",
    "payment_method": "cvu",
    "merchant_order_reference": "ORDER-2026-0001",
    "merchant_transaction_reference": "TRX-2026-0001",
    "merchant_customer_id": "customer@email.com",
    "customer_ip": "120.29.48.92",
    "fields": {
        "first_name": "João",
        "last_name": "Silva",
        "document_number": "20084908488"
    },
    "return_urls": {
        "success_url": "https://merchant.com/payment-success",
        "failure_url": "https://merchant.com/payment-failure",
        "cancel_url": "https://merchant.com/payment-cancelled"
    }
}'
Response Response Example
201 - Argentina CVU
{
    "transaction_id": "20260205-1127-4678-8883-5e4868d33e4e",
    "payment_method_reference": 129930,
    "expires_at": "2026-06-09T14:13:05.143073869Z",
    "instructions": {
        "reference": "WDCMRMNPBE4CG",
        "bank_account": 50053763000179
    }
}
Modified at 2026-06-09 15:16:31
Previous
Search pay-in transactions
Next
Retrieve a pay-in transaction.
Built with