Pagar con Yape
Esta casuística permite a los usuarios realizar un pago utilizando el código Yape. El usuario ingresa un código OTP generado desde la APP de Yape y este es validado en nuestro checkout para completar la transacción y procesar el pago.
Objetivo
Aprenderás a:
- Crear el objeto de configuración
- Inicializar el formulario de pago.
- Mostrar el Checkout.
- Ejemplo de respuesta.
1. Creando el objeto de configuración
const iziConfig = {
config: {
...,
action: 'pay',
order: {
...,
payMethod: 'YAPE_CODE',
},
billing:{
firstName: 'Juan',
lastName: 'Wick Quispe',
email: 'jwickq@izi.com',
phoneNumber: '958745896',
street: 'Av. Jorge Chávez 275',
city: 'Lima',
state: 'Lima',
country: 'PE',
postalCode: '15038',
documentType: 'DNI',
document: '21458796',
},
shipping: {
firstName: 'Juan Sh',
lastName: 'Wick Quispe Sh',
email: 'jwickqsh@izi.com',
phoneNumber: '958745897',
street: 'Av. Jorge Chávez 275',
city: 'Lima',
state: 'Lima',
country: 'PE',
postalCode: '15038',
documentType: 'DNI',
document: '21458798',
}
...
}
};
2. Instanciando la clase
const checkout = new Izipay({ config: iziConfig });
3. Mostrando el checkout
const callbackResponsePayment = (response) => console.log(response);
try {
checkout &&
checkout.LoadForm({
authorization: 'TU_TOKEN_SESSION',
keyRSA: 'TU_KEY_RSA',
callbackResponse: callbackResponsePayment,
});
} catch (error) {
console.log(error.message, error.Errors, error.date);
}
Importante
- Si el comercio solo tiene configurado como método de pago
YAPE
y el monto excede el límite establecido, no se mostrará el checkout. - Si el comercio tiene configurado varios métodos de pago, entre ellos
YAPE
y el monto excede el límite establecido, no se mostrará la hoja de pago.
4. Respuesta
Al finalizar la transacción, nuestro checkout enviará al comercio la respuesta en formato JSON.
- EXITOSO
- RESTRICCIÓN YAPE
- LÍMITE DIARIO
- CUENTA BLOQUEADA POR OTP
- RESTRICCIÓN EMISOR
- OTP VENCIDO
- OTP INVÁLIDO
{
"code": "00",
"message": "Operación exitosa",
"messageUser": "Operación exitosa",
"messageUserEng": "Successful",
"response": {
"payMethod": "YAPE_CODE",
"order": [
{
"payMethodAuthorization": "YAPE_CODE",
"codeAuth": "000500",
"currency": "PEN",
"amount": "149.00",
"installment": "00",
"deferred": "0",
"orderNumber": "1704995421",
"stateMessage": "Autorizado",
"dateTransaction": "20240111",
"timeTransaction": "125141",
"uniqueId": "0111175141811583",
"referenceNumber": "1177350"
}
],
"card": {
"brand": "VS",
"pan": "449577******9759",
"save": "false"
},
"billing": {
"firstName": "Luis",
"lastName": "Quispe",
"email": "luisquispetaquire@gmail.com",
"phoneNumber": "963150123",
"street": "Jorge Chavez 256",
"city": "Lima",
"state": "Lima",
"country": "PE",
"postalCode": "15002",
"documentType": "DNI",
"document": "24010511",
"companyName": ""
},
"merchant": {
"merchantCode": "5599795",
"facilitatorCode": ""
},
"token": {
"merchantBuyerId": "GDTI4562_009",
"cardToken": "",
"alias": ""
},
"authentication": {
"result": ""
},
"customFields": [
{
"name": "field1",
"value": ""
},
{
"name": "field2",
"value": ""
},
{
"name": "field3",
"value": ""
},
{
"name": "field4",
"value": ""
},
{
"name": "field5",
"value": ""
},
{
"name": "field6",
"value": ""
},
{
"name": "field7",
"value": ""
},
{
"name": "field8",
"value": ""
},
{
"name": "field9",
"value": ""
},
{
"name": "field10",
"value": ""
}
]
},
"payloadHttp": "{\"code\":\"00\",\"message\":\"Operación exitosa\",\"messageUser\":\"Operación exitosa\",\"messageUserEng\":\"Successful\",\"response\":{\"payMethod\":\"YAPE_CODE\",\"order\":[{\"payMethodAuthorization\":\"YAPE_CODE\",\"codeAuth\":\"000500\",\"currency\":\"PEN\",\"amount\":\"149.00\",\"installment\":\"00\",\"deferred\":\"0\",\"orderNumber\":\"1704995421\",\"stateMessage\":\"Autorizado\",\"dateTransaction\":\"20240111\",\"timeTransaction\":\"125141\",\"uniqueId\":\"0111175141811583\",\"referenceNumber\":\"1177350\"}],\"card\":{\"brand\":\"VS\",\"pan\":\"449577******9759\",\"save\":\"false\"},\"billing\":{\"firstName\":\"Luis\",\"lastName\":\"Quispe\",\"email\":\"luisquispetaquire@gmail.com\",\"phoneNumber\":\"963150123\",\"street\":\"Jorge Chavez 256\",\"city\":\"Lima\",\"state\":\"Lima\",\"country\":\"PE\",\"postalCode\":\"15002\",\"documentType\":\"DNI\",\"document\":\"24010511\",\"companyName\":\"\"},\"merchant\":{\"merchantCode\":\"5599795\",\"facilitatorCode\":\"\"},\"token\":{\"merchantBuyerId\":\"GDTI4562_009\",\"cardToken\":\"\",\"alias\":\"\"},\"authentication\":{\"result\":\"\"},\"customFields\":[{\"name\":\"field1\",\"value\":\"\"},{\"name\":\"field2\",\"value\":\"a\"},{\"name\":\"field3\",\"value\":\"\"},{\"name\":\"field4\",\"value\":\"\"},{\"name\":\"field5\",\"value\":\"\"},{\"name\":\"field6\",\"value\":\"\"},{\"name\":\"field7\",\"value\":\"\"},{\"name\":\"field8\",\"value\":\"\"},{\"name\":\"field9\",\"value\":\"\"},{\"name\":\"field10\",\"value\":\"\"}]},\"transactionId\":\"170499542026900\"}",
"signature": "wXlqracZYHEtr0glhT8L9PxeSQjgupdiKJZ41zTnf0I=",
"transactionId": "170499542026900"
}
{
"code": "Y06",
"message": "Encontramos restricciones para completar el yapeo.",
"messageUser": "Encontramos restricciones para completar el yapeo.",
"messageUserEng": "We found restrictions to complete the Yapeo",
"response": {
"merchantCode": "4001834",
"orderNumber": "ONTEST174535547",
"amount": "149.00",
"billing": {
"firstName": "Luis",
"lastName": "Quispe",
"email": "luisquispetaquire@gmail.com",
"phoneNumber": "989339999",
"street": "calle el demo",
"city": "lima",
"state": "lima",
"country": "PE",
"postalCode": "00001",
"documentType": "DNI",
"document": "10252022",
"companyName": ""
},
"currency": "PEN",
"dateTransaction": "20250422",
"timeTransaction": "155806",
"payMethod": "Yape",
"card": {
"save": false
},
"signature": "Okq9IaaIxxJ/2onuCWkRGCGpDaz5SqttZIYKdSpvlXA=",
"payloadHttp": "{\"code\":\"Y06\",\"message\":\"Encontramos restricciones para completar el yapeo.\",\"messageUser\":\"Encontramos restricciones para completar el yapeo.\",\"messageUserEng\":\"We found restrictions to complete the Yapeo\",\"response\":{\"merchantCode\":\"4001834\",\"orderNumber\":\"ONTEST174535547\",\"amount\":\"149.00\",\"billing\":{\"firstName\":\"Luis\",\"lastName\":\"Quispe\",\"email\":\"luisquispetaquire@gmail.com\",\"phoneNumber\":\"989339999\",\"street\":\"calle el demo\",\"city\":\"lima\",\"state\":\"lima\",\"country\":\"PE\",\"postalCode\":\"00001\",\"documentType\":\"DNI\",\"document\":\"10252022\",\"companyName\":\"\"},\"currency\":\"PEN\",\"dateTransaction\":\"20250422\",\"timeTransaction\":\"155806\",\"payMethod\":\"Yape\",\"card\":{\"save\":false}}}"
}
}
{
"code": "Y07",
"message": "Esta operación excede tu monto limite diario para comprar por internet.",
"messageUser": "Esta operación excede tu monto limite diario para comprar por internet.",
"messageUserEng": "This operation exceeds your daily limit amount for online purchases",
"response": {
"merchantCode": "4001834",
"orderNumber": "ONTEST174535589",
"amount": "980.00",
"billing": {
"firstName": "Luis",
"lastName": "Quispe",
"email": "luisquispetaquire@gmail.com",
"phoneNumber": "989339999",
"street": "calle el demo",
"city": "lima",
"state": "lima",
"country": "PE",
"postalCode": "00001",
"documentType": "DNI",
"document": "10252022",
"companyName": ""
},
"currency": "PEN",
"dateTransaction": "20250422",
"timeTransaction": "161021",
"payMethod": "Yape",
"card": {
"save": false
},
"signature": "nE54Yj2rH81XOsLzTa+Lf9f86CfT7VGvSAjDU7ZCB6Q=",
"payloadHttp": "{\"code\":\"Y07\",\"message\":\"Esta operación excede tu monto limite diario para comprar por internet.\",\"messageUser\":\"Esta operación excede tu monto limite diario para comprar por internet.\",\"messageUserEng\":\"This operation exceeds your daily limit amount for online purchases\",\"response\":{\"merchantCode\":\"4001834\",\"orderNumber\":\"ONTEST174535589\",\"amount\":\"980.00\",\"billing\":{\"firstName\":\"Luis\",\"lastName\":\"Quispe\",\"email\":\"luisquispetaquire@gmail.com\",\"phoneNumber\":\"989339999\",\"street\":\"calle el demo\",\"city\":\"lima\",\"state\":\"lima\",\"country\":\"PE\",\"postalCode\":\"00001\",\"documentType\":\"DNI\",\"document\":\"10252022\",\"companyName\":\"\"},\"currency\":\"PEN\",\"dateTransaction\":\"20250422\",\"timeTransaction\":\"161021\",\"payMethod\":\"Yape\",\"card\":{\"save\":false}}}"
}
}
{
"code": "Y08",
"message": "Tu cuenta esta bloqueada temporalmente.",
"messageUser": "Tu cuenta esta bloqueada temporalmente.",
"messageUserEng": "Your account is temporarily blocked",
"response": {
"merchantCode": "4001834",
"orderNumber": "ONTEST174535662",
"amount": "149.00",
"billing": {
"firstName": "Luis",
"lastName": "Quispe",
"email": "luisquispetaquire@gmail.com",
"phoneNumber": "989339999",
"street": "calle el demo",
"city": "lima",
"state": "lima",
"country": "PE",
"postalCode": "00001",
"documentType": "DNI",
"document": "10252022",
"companyName": ""
},
"currency": "PEN",
"dateTransaction": "20250422",
"timeTransaction": "161710",
"payMethod": "Yape",
"card": {
"save": false
},
"signature": "Zi9HXqyzHkQ/SkO76wo2ZF9WAtlfGlwKjSxpF/pQD4g=",
"payloadHttp": "{\"code\":\"Y08\",\"message\":\"Tu cuenta esta bloqueada temporalmente.\",\"messageUser\":\"Tu cuenta esta bloqueada temporalmente.\",\"messageUserEng\":\"Your account is temporarily blocked\",\"response\":{\"merchantCode\":\"4001834\",\"orderNumber\":\"ONTEST174535662\",\"amount\":\"149.00\",\"billing\":{\"firstName\":\"Luis\",\"lastName\":\"Quispe\",\"email\":\"luisquispetaquire@gmail.com\",\"phoneNumber\":\"989339999\",\"street\":\"calle el demo\",\"city\":\"lima\",\"state\":\"lima\",\"country\":\"PE\",\"postalCode\":\"00001\",\"documentType\":\"DNI\",\"document\":\"10252022\",\"companyName\":\"\"},\"currency\":\"PEN\",\"dateTransaction\":\"20250422\",\"timeTransaction\":\"161710\",\"payMethod\":\"Yape\",\"card\":{\"save\":false}}}"
}
}
{
"code": "Y09",
"message": "Opcion valida sólo para Yape con BCP.",
"messageUser": "Opcion valida sólo para Yape con BCP.",
"messageUserEng": "Option valid only for Yape with BCP.",
"response": {
"merchantCode": "4001834",
"orderNumber": "ONTEST174535511",
"amount": "149.00",
"billing": {
"firstName": "Luis",
"lastName": "Quispe",
"email": "luisquispetaquire@gmail.com",
"phoneNumber": "989339999",
"street": "calle el demo",
"city": "lima",
"state": "lima",
"country": "PE",
"postalCode": "00001",
"documentType": "DNI",
"document": "10252022",
"companyName": ""
},
"currency": "PEN",
"dateTransaction": "20250422",
"timeTransaction": "155248",
"payMethod": "Yape",
"card": {
"save": false
},
"signature": "lBWh6R24TP6bcOu4Hsi5QsDK8I/jGO6Y4sQUXUPr/+4=",
"payloadHttp": "{\"code\":\"Y09\",\"message\":\"Opcion valida sólo para Yape con BCP.\",\"messageUser\":\"Opcion valida sólo para Yape con BCP.\",\"messageUserEng\":\"Option valid only for Yape with BCP.\",\"response\":{\"merchantCode\":\"4001834\",\"orderNumber\":\"ONTEST174535511\",\"amount\":\"149.00\",\"billing\":{\"firstName\":\"Luis\",\"lastName\":\"Quispe\",\"email\":\"luisquispetaquire@gmail.com\",\"phoneNumber\":\"989339999\",\"street\":\"calle el demo\",\"city\":\"lima\",\"state\":\"lima\",\"country\":\"PE\",\"postalCode\":\"00001\",\"documentType\":\"DNI\",\"document\":\"10252022\",\"companyName\":\"\"},\"currency\":\"PEN\",\"dateTransaction\":\"20250422\",\"timeTransaction\":\"155248\",\"payMethod\":\"Yape\",\"card\":{\"save\":false}}}"
}
}
{
"code": "Y12",
"message": "El código está vencido o es incorrecto.",
"messageUser": "El código está vencido o es incorrecto.",
"messageUserEng": "The code is expired or incorrect.",
"response": {
"merchantCode": "4001834",
"orderNumber": "ONTEST174535640",
"amount": "149.00",
"billing": {
"firstName": "Luis",
"lastName": "Quispe",
"email": "luisquispetaquire@gmail.com",
"phoneNumber": "989339999",
"street": "calle el demo",
"city": "lima",
"state": "lima",
"country": "PE",
"postalCode": "00001",
"documentType": "DNI",
"document": "10252022",
"companyName": ""
},
"currency": "PEN",
"dateTransaction": "20250422",
"timeTransaction": "161440",
"payMethod": "Yape",
"card": {
"save": false
},
"signature": "Y59ppgFmBUGoOL9vTFojNVuw7IZAd5U6TGotJ8bVc1U=",
"payloadHttp": "{\"code\":\"Y12\",\"message\":\"El código está vencido o es incorrecto.\",\"messageUser\":\"El código está vencido o es incorrecto.\",\"messageUserEng\":\"The code is expired or incorrect.\",\"response\":{\"merchantCode\":\"4001834\",\"orderNumber\":\"ONTEST174535640\",\"amount\":\"149.00\",\"billing\":{\"firstName\":\"Luis\",\"lastName\":\"Quispe\",\"email\":\"luisquispetaquire@gmail.com\",\"phoneNumber\":\"989339999\",\"street\":\"calle el demo\",\"city\":\"lima\",\"state\":\"lima\",\"country\":\"PE\",\"postalCode\":\"00001\",\"documentType\":\"DNI\",\"document\":\"10252022\",\"companyName\":\"\"},\"currency\":\"PEN\",\"dateTransaction\":\"20250422\",\"timeTransaction\":\"161440\",\"payMethod\":\"Yape\",\"card\":{\"save\":false}}}"
}
}
{
"code": "Y13",
"message": "El código es incorrecto.",
"messageUser": "El código es incorrecto.",
"messageUserEng": "The code is incorrect.",
"response": {
"merchantCode": "4001834",
"orderNumber": "ONTEST174535560",
"amount": "149.00",
"billing": {
"firstName": "Luis",
"lastName": "Quispe",
"email": "luisquispetaquire@gmail.com",
"phoneNumber": "989339999",
"street": "calle el demo",
"city": "lima",
"state": "lima",
"country": "PE",
"postalCode": "00001",
"documentType": "DNI",
"document": "10252022",
"companyName": ""
},
"currency": "PEN",
"dateTransaction": "20250422",
"timeTransaction": "160018",
"payMethod": "Yape",
"card": {
"save": false
},
"signature": "z10oTk9R/etmPUvRpdWjvgLX+NEvZaIG9qgJyU+HqBA=",
"payloadHttp": "{\"code\":\"Y13\",\"message\":\"El código es incorrecto.\",\"messageUser\":\"El código es incorrecto.\",\"messageUserEng\":\"The code is incorrect.\",\"response\":{\"merchantCode\":\"4001834\",\"orderNumber\":\"ONTEST174535560\",\"amount\":\"149.00\",\"billing\":{\"firstName\":\"Luis\",\"lastName\":\"Quispe\",\"email\":\"luisquispetaquire@gmail.com\",\"phoneNumber\":\"989339999\",\"street\":\"calle el demo\",\"city\":\"lima\",\"state\":\"lima\",\"country\":\"PE\",\"postalCode\":\"00001\",\"documentType\":\"DNI\",\"document\":\"10252022\",\"companyName\":\"\"},\"currency\":\"PEN\",\"dateTransaction\":\"20250422\",\"timeTransaction\":\"160018\",\"payMethod\":\"Yape\",\"card\":{\"save\":false}}}"
}
}
Demo
A continuación, te invitamos a explorar nuestra demo interactiva.
Editor en vivo
Resultado
Loading...