PagoMovil PayIn

Payment registration transactions

PagoMovil HPP & H2H


1. PagoMovil PayIn

 
Description:
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
 

Request Parameters:

Parameter
Type
Description
Requeriment
service_code
string
PM_VEN
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
payer_phone
num
Payer’s cellphone number.
required
account_bank
num
Code of specific bank of payer. It’s provided
required
account_inter_bank_code
num
Reference number of the transaction given by the payer’s bank. It can be found in the “Comprobante” or Proof of Deposit. Last 8 digits
required

PagoMovil Example Request:

{ "service_code": "PM_VEN", "amount": 30, "reference": "0000000000002507135224", "rq_account_doc_id": "10515819", "rq_account_bank": "0134", "rq_payer_phone": "04166297980", "rq_account_inter_bank_code": "92471846" }

PagoMovil Example Response:

{ "status": "success", "data": { "transaction_id": "LTKTX3", "amount": 30, "currency": "VES", "status": "COMPLETED", "reference": "0000000000002507135224", "created_at": "2025-07-29T15:41:51.005604+00:00", "updated_at": "2025-07-29T15:41:51.005604+00:00", "message": "Transacción Encontrada" "redirect_hpp_url": "XXXXXXX" }
After receiving redirect_hpp_url, you need to redirect the client to the URL and wait for the final status of the transaction.