Yape PayIn

Description:

Yape is a Peruvian mobile payment app — the most widely used digital wallet in Peru. It's operated by BCP (Banco de Crédito del Perú), the country's largest bank.

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

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

Country Uses:

Perú: Yape

Request Parameters:

Parameter	Type	Description	Requeriment
`service_code`	string	’`YAPE_PE`’	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	Client ID number	required
`account_doc_type`	string	Type of tax document or identity document. Supported identity/tax documents: `DNI` Documento Nacional de Identidad `RUC` Registro Único de Contribuyentes `CE` Carné de Extranjería `PPN` Pasaporte	required

QR Bank Transfers Example Request:


{
    "service_code": "YAPE_PE",
    "amount": 15,
    "reference": "{{payin_ref}}",
    "account_doc_id": "75406193",
    "account_doc_type": "DNI"
}

QR Bank Transfers Example Response:


{
    "status": "success",
    "data": {
        "transaction_id": "ohNuuAoX5m6Et1E",
        "amount": 15,
        "currency": "PEN",
        "status": "PENDING",
        "reference": "PAY1335688965",
        "created_at": "2026-06-03T17:04:06.252141+00:00",
        "updated_at": "2026-06-03T17:04:06.252141+00:00",
        "expired_at": "2026-06-04T05:04:06.252141+00:00",
        "brCode": "XXXXB",
        "redirect_hpp_url": "XXXXX"
    }
}

After receiving redirect_hpp_url, you need to redirect the client to the URL and wait for the final status of the transaction.

Yape HPP & H2H 1. Yape Country Uses:Request Parameters:QR Bank Transfers Example Request:QR Bank Transfers Example Response: