PagoMovil PayIn Channel 2

PagoMovil is a mobile payment system in Venezuela that allows users to send and receive money instantly between bank accounts using just a phone number, national ID (cédula), and the recipient’s bank name. It operates through participating Venezuelan banks and is commonly used for quick, everyday transactions without needing full account details. Once users register their phone number with their bank, they can transfer funds in real time through their bank’s app or SMS service.

Allows the creation of pay-ins (incoming payments).

URL:https://api.payelu.xyz/api/v1/payments/payin_hth

Country Uses:

Venezuela: PagoMovil

Before you can initiate any payment transaction in PagoMovil, you must first create a payment order.

The payment order acts as a unique reference that represents the transaction in the PagoMovil system. All subsequent operations — such as confirming, canceling, or querying a payment — will reference this order.

Request Parameters:

Create Order PM Example Request:

Parameter	Type	Description	Requeriment
`service_code`	string	’`PM_VEN2`’	required
`amount`	num	Amount to process. e.g. `123.45`	required
`reference`	string	Merchant’s Unique ID for transaction. It must be 22 alfanumeric digits (i.e. ‘`0000000000002507135224`‘)	required
`account_doc_id`	num	Payer’s National ID which is “Cédula de Identidad”	required
`account_state`	string	`create_order` To create payment order	required

Create Order PM Example Request:


{
    "service_code": "PM_VEN2",
    "amount": 35,
    "reference": "REF-PM2324234-011123",
    "rq_account_doc_id": "14155015",
    "rq_account_state": "create_order"
}

Create Order PM Example Response:


{
    "status": "success",
    "data": {
        "transaction_id": "3Z0YJB8",
        "amount": 35,
        "currency": "VES",
        "status": "PENDING",
        "reference": "REF-PM2324234-011123",
        "created_at": "2025-10-07T20:34:35.076712+00:00",
        "updated_at": "2025-10-07T20:34:35.076712+00:00",
        "pago_movil_instructions": {
            "monto": "35",
            "cedula": "14155015",
            "telefono": "XXXXXXXXX",
            "banco": "XXXXXX"
        }
    }
}

After the payment order is successfully created, the customer must complete the payment using PagoMovil. Once the payment has been made, the customer can validate the payment status to confirm whether it was successfully processed.

Create PagoMovil Example Request:

Parameter	Type	Description	Requeriment
`service_code`	string	’`PM_VEN2`’	required
`amount`	num	Amount to process. e.g. `123.45`	required
`reference`	string	Merchant’s Unique ID for transaction. It must be 22 alfanumeric digits (i.e. ‘`0000000000002507135224`‘)	required
`account_doc_id`	num	Payer’s National ID which is “Cédula de Identidad”	required
`account_state`	string	`verify` To verify the PagoMovil	required

Create PagoMovil Example Request:


{
    "service_code": "PM_VEN2",
    "amount": 35,
    "reference": "REF-PM2324234-011123",
    "rq_account_doc_id": "14155015",
    "rq_account_state": "verify"
}

Create PagoMovil Example Response:


{
    "status": "success",
    "data": {
        "transaction_id": "3Z0YJB8",
        "amount": 35,
        "currency": "VES",
        "status": "PENDING",
        "reference": "REF-PM2324234-011123",
        "created_at": "2025-10-07T20:38:51.294443+00:00",
        "updated_at": "2025-10-07T20:38:51.294443+00:00",
        "message": "Esperando pago"
    }
}

To validate a PagoMovil payment, the customer must send a PagoMovil PayIn request.

This request will return the current status of the payment — which can be one of the following:

✅ COMPLETED – The payment was successfully processed.

⏳ PENDING – The payment is still being verified.

❌ ERROR – The payment failed or could not be confirmed.

⚠️ Important: The payment must be completed before verification. The customer should make the payment using the bank details provided in the payment order.

Once the payment is made, the customer can then proceed to verify or continue the process.

PagoMovil HPP & H2H 1. PagoMovil PayIn Country Uses:Request Parameters:Create Order PM Example Request:Create Order PM Example Request:Create Order PM Example Response:Create PagoMovil Example Request:Create PagoMovil Example Request:Create PagoMovil Example Response: