Paraguay BT PayIn

Payment registration transactions

Paraguay BT HPP & H2H

1. Paraguay BT PayIn

Description:
Bank Transfer Paraguay using BTWA_PY, payments to be made via online banking
 
Allows the creation of pay-ins (incoming payments).
 
URL:https://api.payelu.xyz/api/v1/payments/payin_hth
 

Country Uses:

  • Paraguay: BTWA_PY
 

Request Parameters:

Parameter
Type
Description
Requeriment
service_code
string
’BTWA_PY’
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
payer_doc_id
string
Sender's Doc ID.
required

BTWA_PYE Example Request:

{
    "service_code": "BTWA_PY",
    "amount": 15.21,
    "reference": "PAY0835698813",
	  "rq_payer_doc_id": "1234567890"
}

BTWA_PY Example Response:

{
    "status": "success",
    "data": {
        "transaction_id": "22342477",
        "amount": 15.21,
        "currency": "PYG",
        "reference": "PAY0835698813",
        "status": "PENDING",
        "created_at": "2026-02-05T20:15:41.873675+00:00",
        "updated_at": "2026-02-05T20:15:41.873675+00:00",
        "payment_instructions": {
            "title": "PAYELU BTWA_PY",
            "subtitle": "Entre en su App de Banco y siga las instrucciones",
            "line1": "1) Entra a tu app bancaria, elije la opción 'Pago de Servicio'",
            "line2": "2.-Busque al proveedor PAYELU",
            "line3": "Copia y pega el número de referencia de la factura 22342477",
            "line4": "Realiza el pago por el monto (PYG 15.21) indicado y vuelve a esta página",
            "line5": "",
            "line6": "",
            "line7": "",
            "line8": "",
            "line9": "",
            "line10": ""
        },
        "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.