Punto Web - American Express
Anuncio
MANUAL INTEGRACIÓN PUNTO WEB PARÁMETROS DE COMUNICACIÓN ___________________________________________________________________________________________________________ Documento confidencial para uso interno, prohibida su reproducción parcial o total Página 1 de 11 Versión 1.00 Fecha de Publicación 01/08/2014 MANUAL INTEGRACIÓN PUNTO WEB: PARÁMETROS DE COMUNICACIÓN HOJA DE CONTROL DE CAMBIOS Antecedentes: (Si los hubiera) Fecha 25/07/2014 Descripción del Cambio Publicación Manual de Integración Versión 1.00 Autorizado por: P.Mendoza B.Polanco ___________________________________________________________________________________________________________ Documento confidencial para uso interno, prohibida su reproducción parcial o total Página 2 de 11 Versión 1.00 Fecha de Publicación 01/08/2014 MANUAL INTEGRACIÓN PUNTO WEB: PARÁMETROS DE COMUNICACIÓN CONTENIDO DEFINICIÓN TÉCNICA DE INTEGRACIÓN ..............................................................4 Comercios con Pantalla de Ingreso de Tarjeta..................................................................... 4 Autorización ....................................................................................................................................... 4 Valores de Input ........................................................................................................................ 4 Valores de Output ..................................................................................................................... 6 Datos de Respuesta para visualización del Tarjetahabiente .............................................. 8 Autorización Aprobada .................................................................................................................... 8 Autorización Desaprobada ............................................................................................................... 9 Códigos de Respuesta .............................................................................................................10 Lista de Valores para el O13 .......................................................................................................... 10 _____________________________________________________________________________________________________________ Documento confidencial para uso interno, prohibida su reproducción parcial o total Página 3 de 11 Versión 1.00 Fecha de Publicación 01/08/2014 MANUAL INTEGRACIÓN PUNTO WEB: PARÁMETROS DE COMUNICACIÓN DEFINICIÓN TÉCNICA DE INTEGRACIÓN Comercios con Pantalla de Ingreso de Tarjeta Al iniciar el pago por la pasarela de PUNTO WEB, los parámetros serán enviados por el método POST mediante campos ocultos y enviados al URL especificado. Autorización Dirección Url definida para las pruebas en español: https://server.punto-web.com/gateway/PagoWebAM.asp Dirección Url definida para las pruebas en inglés: https://server.punto-web.com/gateway/PagoWebEngAM.asp Valores de Input En el siguiente cuadro se muestran los parámetros requeridos y sus respectivos significados. Variables de Input Descripción Valor I1 Código de Comercio 2999994 I2 Nro. de Referencia (Generado por el Comercio) I3 Monto de la Transacción 22.50 I4 Moneda de la Transacción USD/PEN I5 Fecha de la Transacción 20050101 I6 Hora de la Transacción 172525 I7 Autogenerador Aleatorio (Podría ser un Timestamp) I8 Código del Cliente ORD0001 A3456451215 REG0001 Tipo: Numérico Longitud Min:7-Max:7 Tipo: Alfanumérico Longitud Min:5-Max:15 Tipo: Decimal Longitud Min:4-Max:9 (Incluido dos decimales. Sin delimitador de miles) Símbolo decimal: (.) Tipo: Carácter Longitud Min:3-Max:3 Tipo: Numérico Longitud Min:8-Max:8 Formato: YYYYMMDD Tipo: Numérico Longitud Min: 6-Max:6 Formato: HHMMSS Tipo: Alfanumérico Longitud Min:11-Max:20 Tipo: Alfanumérico Longitud Min:5-Max:20 _____________________________________________________________________________________________________________ Documento confidencial para uso interno, prohibida su reproducción parcial o total Página 4 de 11 Versión 1.00 Fecha de Publicación 01/08/2014 MANUAL INTEGRACIÓN PUNTO WEB: PARÁMETROS DE COMUNICACIÓN Variables de Input Descripción Valor I9 Código de País de la Txn PER I10 Firma-HMAC SHA1 Firma Tipo: Alfanumérico Longitud Min:3-Max:5 Valor por defecto: PER Tipo: Base 64 (Utilizar el UrlEncode) El parámetro I7 debe ser auto generado y aleatorio, este valor es relacionado con el I2, si el usuario de la pagina al momento de pagar desea realizar algún cambio (agregar y quitar producto del carrito de compra) el envió del I7 debe ser diferente manteniéndose el I2 correspondiente a la orden cliente. Ejemplo de envío de parámetros: <form method=”POST” action=”Url” name=”form”> <input type=”hidden” name=”I1” value=”2999994”> <input type=”hidden” name=”I2” value=”ORD0001”> <input type=”hidden” name=”I3” value=”22.50”> <input type=”hidden” name=”I4” value=”PEN”> <input type=”hidden” name=”I5” value=”20050101”> <input type=”hidden” name=”I6” value=”172525”> <input type=”hidden” name=”I7” value=”A1345521065”> <input type=”hidden” name=”I8” value=”REG001”> <input type=”hidden” name=”I9” value=”PER”> <input type=”hidden” name=”I10” value=”Firma”> </form> _____________________________________________________________________________________________________________ Documento confidencial para uso interno, prohibida su reproducción parcial o total Página 5 de 11 Versión 1.00 Fecha de Publicación 01/08/2014 MANUAL INTEGRACIÓN PUNTO WEB: PARÁMETROS DE COMUNICACIÓN Valores de Output Luego que la pasarela recibe los datos (valores InPut) y el tarjeta habiente realiza la transacción, los datos de respuesta (valores Output) son enviados a una página predefinida y configurada por el comercio. Variables de Output O1 O2 O3 Descripción Resultado de la transacción Código de Autorización (Generado por PMCP) Número de Referencia (Generado por Punto-Web) Valor A = Aceptada D = Denegada E = Error R56488 PV0121001883 O4 Número de Cuota 0 O5 Fecha de Primera Cuota 01/01/2005 O6 Moneda de Cuota USD/PEN O7 Monto de Cuota 12.34 O8 Moneda de Monto Total USD/PEN O9 Monto Total 22.50 O10 Nro. de Referencia (ECO del I2) ORD0001 O11 Fecha de la Transacción 20050101 O12 Hora de la Transacción 172525 Tipo: Carácter Longitud Min:1-Max:1 Tipo: Alfanumérico Longitud Min:6-Max:6 Tipo: Alfanumérico Longitud Min:12-Max:12 Tipo: Numérico Longitud Min:1-Max:2 Tipo: Alfanumérico Longitud Min:10-Max:10 Formato: DDMMYYYY Se incluye, Solo si hay cuotas Tipo: Carácter Longitud Min: 3-Max:3 Se incluye solo si hay cuotas Tipo: Decimal Longitud Min:4-Max:9 (Incluido dos decimales, sin delimitador de miles) Se incluye, solo si hay cuota Tipo: Carácter Longitud Min:3-Max:3 Tipo: Decimal Longitud Min:4-Max:9 (Incluido dos decimales, sin delimitador de miles) Símbolo decimal: (.) Tipo: Alfanumérico Longitud Min:5-Max:15 Tipo: Numérico Longitud Min:8-Max:8 Formato: YYYYMMDD Tipo: Numérico Longitud Min:6-Max:6 _____________________________________________________________________________________________________________ Documento confidencial para uso interno, prohibida su reproducción parcial o total Página 6 de 11 Versión 1.00 Fecha de Publicación 01/08/2014 MANUAL INTEGRACIÓN PUNTO WEB: PARÁMETROS DE COMUNICACIÓN Variables de Output Descripción Valor Formato: HHMMSS O13 Código de Respuesta 00 Tipo: Alfanumérico Longitud Min:2-Max:2 O14 Código de País PER Tipo: Carácter Longitud Min:3-Max:3 O15 Nro. De Tarjeta (Asterisqueada) 377550******0856 Tipo: Alfanumérico Longitud Min:16-Max:19 O16 SecureCode 00 Tipo: Numérico Longitud Min:2-Max:2 O17 Mensaje de Respuesta (O13) Texto Tipo: Carácter Longitud: 30 O18 Código del Cliente (ECO del I8) REG001 Tipo: Alfanumérico Longitud Min:5-Max:20 O19 Código de País de la Txn PER Tipo: Alfanumérico Longitud Min:3-Max:5 O20 Firma – HMAC SHA1 Firma Tipo: Base64 Se enviará UrlEncode con el _____________________________________________________________________________________________________________ Documento confidencial para uso interno, prohibida su reproducción parcial o total Página 7 de 11 Versión 1.00 Fecha de Publicación 01/08/2014 MANUAL INTEGRACIÓN PUNTO WEB: PARÁMETROS DE COMUNICACIÓN Datos de Respuesta para visualización del Tarjetahabiente Se requiere que la lista de datos indicada, sea mostrada al tarjetahabiente como información de respuesta de la transacción. Autorización Aprobada Variables de Output 01 Descripción Valor ORD0001 Tipo: Alfanumérico Longitud Min:5-Max:15 02 Nro Referencia (Generado por el Comercio) Fecha Transacción 01/02/2012 Tipo: Numérico Longitud Min:10 – Max:10 Formato: DD/MM/YYYY 03 Hora Transacción 10:10:10 04 Código de Autorización Monto Transacción R12021 Numero de Tarjeta (Opcional) Mensaje de Respuesta 377750******0856 Tipo: Numérico Longitud Min:8 – Max:8 Formato: HH:MM:SS Tipo: Alfanumérico Longitud Min:6 – Max:6 Tipo: Decimal Longitud Min: 4 – Max: 9 (incluido dos decimales, sin delimitador de miles) Símbolo decimal: (.) Tipo: Alfanumérico Longitud Min:16 – Max:19 Tipo: Alfanumérico Longitud 30 máximo 05 06 07 22.50 Texto _____________________________________________________________________________________________________________ Documento confidencial para uso interno, prohibida su reproducción parcial o total Página 8 de 11 Versión 1.00 Fecha de Publicación 01/08/2014 MANUAL INTEGRACIÓN PUNTO WEB: PARÁMETROS DE COMUNICACIÓN Autorización Desaprobada Variables de Output 01 Descripción Valor ORD0001 Tipo: Alfanumérico Longitud Min:5-Max:15 02 Nro Referencia (Generado por el Comercio) Fecha Transacción 01/02/2012 Tipo: Numérico Longitud Min:10 – Max:10 Formato: DD/MM/YYYY 03 Hora Transacción 10:10:10 04 Monto Transacción 22.50 05 Numero de Tarjeta (Opcional) Mensaje de Respuesta 377750******0856 Tipo: Numérico Longitud Min:8 – Max:8 Formato: HH:MM:SS Tipo: Decimal Longitud Min: 4 – Max: 9 (incluido dos decimales, sin delimitador de miles) Símbolo decimal: (.) Tipo: Alfanumérico Longitud Min:16 – Max:19 Tipo: Alfanumérico Longitud 30 máximo 06 Texto _____________________________________________________________________________________________________________ Documento confidencial para uso interno, prohibida su reproducción parcial o total Página 9 de 11 Versión 1.00 Fecha de Publicación 01/08/2014 MANUAL INTEGRACIÓN PUNTO WEB: PARÁMETROS DE COMUNICACIÓN Códigos de Respuesta Lista de Valores para el O13 VALUE 00 01 03 04 05 12 13 14 15 30 41 43 45 51 54 57 58 61 62 63 65 76 77 78 84 91 92 94 96 AUTORIZACIONES DESCRIPCIÓN Approved or Completed Successfully Refer to Card Issuer Invalid Merchant Capture Card Denegado Invalid Transaction Invalid Amount Invalid Card Number Invalid Issuer Format Error Lost Card Stolen Card Tarj. Es cuotas Insufficiente Funds/Over Credit Limit Expire Card Transaction not Permitted to Issuer/Cardholder Transaction not Permitted to Acquirer/Terminal Exceeds Withdrawal Amount Limit Restricted Card Security Violation Exceeds Withdrawal Count Limit Invalid/Non Existent “To” Account Specified Invalid/Non Existent “From” Account Specified Invalid/Non Existent Account Specified (General) Invalid Authorization Life Cycle Authorization System or Issuer System Inoperative Unable to Route Transaction Duplicate Transmission Detected System Error ACTION Approve Decline Decline Decline Decline Decline Decline Decline Decline Decline Decline Decline Decline Decline Decline Decline Decline Decline Decline Decline Decline Decline Decline Decline Decline Decline Decline Decline Decline _____________________________________________________________________________________________________________ Documento confidencial para uso interno, prohibida su reproducción parcial o total Página 10 de 11 Versión 1.00 Fecha de Publicación 01/08/2014 MANUAL INTEGRACIÓN PUNTO WEB: PARÁMETROS DE COMUNICACIÓN PUNTO WEB Value ND PD KD NR NC NE IM FI HI ID IC IA CC MC SM EC HM OC Pag. Español Punto-Web Sistema No Disponible Punto-Web Permiso Denegado Punto-Web Llave Denegada Punto-Web Número de Referencia Inválido Punto-Web CVC2 Inválido Punto-Web Fecha de Expiración Inválida Punto-Web Moneda Inválida Punto-Web Fecha Inválida Punto-Web Hora Inválida Punto-Web Diferido Inválido Punto-Web Cuota Inválida Punto-Web Monto Inválido Punto-Web Tarjeta de Crédito Inválida Punto-Web Comercio Inválido Punto-Web Secure Code Mensaje (Ver O16) Punto-Web Error de Criptografía Punto-Web Hash Inválido Punto-Web Orden Cancelada Pag. Inglés Punto-Web System Non Available Punto-Web Denied Permission Punto-Web Key Denied Punto-Web Invalid Reference Number Punto-Web Invalid CVC2 Punto-Web Invalid Expiration Date Punto-Web Invalid Currency Punto-Web Invalid Date Punto-Web Invalid Time Punto-Web Diferido Inválido Punto-Web Cuota Inválida Punto-Web Invalid Amount Punto-Web Invalid Credit Card Action Error Punto-Web Invalid Merchant Punto-Web Secure Code Mensaje (Ver O16) Punto-Web Cryptography Error Punto-Web Invalid Hash Punto-Web Canceled Order Error Error Error Error Error Error Error Error Error Error Error Error Error Error Error Error Error _____________________________________________________________________________________________________________ Documento confidencial para uso interno, prohibida su reproducción parcial o total Página 11 de 11 Versión 1.00 Fecha de Publicación 01/08/2014
