7/25/2019 Guia Para La Integracion

1/18

Gua de BienvenidaHosted Payment Page

e-Comm

7/25/2019 Guia Para La Integracion

2/18

INDICE

Contenido

Descripcin del ProductoFlujo de la transaccinComenzar la integracin de Hosted Payment Page Integracin BsicaCampos OligatoriosComenzar la integracin de Hosted Payment Page Integracin !egresoa "!#!eporting $PIDescripcin del Producto

#a integracin de Hosted Payment Page le permite reciir pagos atra%&s de una pgina 'e segura (ue cumple con certi)cacin PCI* Coneste modelo de integracin+ nunca se %e ni se administran los detallesdel pago directamente+ por(ue dic,os detalles se ingresan en la pginade pago segura de Baname-

Hosted Payment Page se puede implementar a tra%&s de.

#ig,t o-. "n cuadro de dilogo sore el sitio del negocio Hosted Payment Page. Pgina de pago de Baname-*

/l negocio deer elegir cul de estas dos %istas (uiere utilizar almomento de (ue el tarjeta,aiente realice el pago*

$ continuacin podr encontrar ejemplo de las pantallas de cada unade estas %istas.

Ligt !o"

7/25/2019 Guia Para La Integracion

3/18

Hosted Payment Page

7/25/2019 Guia Para La Integracion

4/18

7/25/2019 Guia Para La Integracion

5/18

/-isten dos tipos de integracin para Hosted Payment Page.

7/25/2019 Guia Para La Integracion

6/18

#lu$o de la transaccin

Integracin B%sica

0* /l tarjeta,aiente ingresa al sitio del negocio y da clic1 en Pagar*2* 3e redirecciona al tarjeta,aiente al sitio seguro de Baname- en

donde ingresar los datos de la tarjeta para realizar la compra*4sta pgina puede tener un ni%el sico de personalizacin*

5* /l tarjeta,aiente se redirecciona al sitio seguro de autenticacinde 6isa 76eri)ed y 6isa8 o 9asterCard 79asterCard 3ecure Code8en donde se le pedirn algunos datos de con)rmacin elegidospor cada emisor para identi)car al tarjeta,aiente*

:* "na %ez realizado el pago Baname- mostrar el resultado de latransaccin 7!ecio8+ en la pgina segura de Baname-*

;O

7/25/2019 Guia Para La Integracion

7/18

Comen*ar la integracin de Hosted Payment Page &IntegracinB%sica)

Para comenzar la integracin usted deer ingresar a la siguiente liga.

,ttps.>>secure*na*tnspayments*com>api>documentation>integration?uidelines>,ostedPaymentPage>integration9odelHostedC,ec1out*,tml endonde encontrar la documentacin de Hosted Cec+out

#e aparecer la siguiente pgina en donde usted podr %er los pasospara la integracin

https://secure.na.tnspayments.com/api/documentation/integrationGuidelines/hostedPaymentPage/integrationModelHostedCheckout.htmlhttps://secure.na.tnspayments.com/api/documentation/integrationGuidelines/hostedPaymentPage/integrationModelHostedCheckout.htmlhttps://secure.na.tnspayments.com/api/documentation/integrationGuidelines/hostedPaymentPage/integrationModelHostedCheckout.htmlhttps://secure.na.tnspayments.com/api/documentation/integrationGuidelines/hostedPaymentPage/integrationModelHostedCheckout.html

7/25/2019 Guia Para La Integracion

8/18

Para realizar esta integracin dee seguir los siguientes 5 pasos.

0* Consulte el arc,i%o c,ec1out*js en los ser%idores del gate'ay*

2* #lame al m&todo C,ec1out*con)gure78+ usando un ojeto @3O;con las especi)caciones de pago+ con)guracin de interAaz einteraccin del usuario*

5* Inicie el proceso de pago llamando a uno de los siguientesm&todos.

Para mostrar las pginas de interaccin con eltarjeta,aiente de #ig,to-.

o C,ec1out*s,o'#ig,to-78

Para mostrar las pginas de interaccin con eltarjeta,aiente de Hosted Payment Page.

o C,ec1out*s,o'PaymentPage78

Para la integracin ms sencilla puede incluir solamente los camposoligatorios los cuales se presentan en el siguiente ejemplo+ teniendocuidado de modi)car los campos resaltados en amarillo con lainAormacin relati%a a su negocio.

,tml

,ead

scriptsrcE,ttps.>>secure*na*tnspayments*com>c,ec1out>%ersion>2>c,ec1out*jsE

dataGerrorEerrorCallac1E

dataGcancelEcancelCallac1E

>script

script typeEte-t>ja%ascriptE

7/25/2019 Guia Para La Integracion

9/18

Aunction errorCallac17error8

console*log7@3O;*stringiAy7error88

J

Aunction cancelCallac178

console*log7KPayment cancelledK8

J

C,ec1out*con)gure7

merc,ant. KyourLmerc,antLidK+

order.

amount. Aunction78

>>Dynamic calculation oA amount

return MN 2N

J+

currency. K9;K+

description. KOrdered goodsK+

id. Kuni(ueLorderLidK

J+

interaction.

merc,ant.

name. KQour merc,ant nameK+

address.

line0. K2NN 3ample 3tK+

line2. K025: /-ample

7/25/2019 Guia Para La Integracion

10/18

J

J

J

J8

>script

>,ead

ody

***

input typeEuttonE %alueEPay 'it, #ig,to-Eonclic1EC,ec1out*s,o'#ig,to-78E >

input typeEuttonE %alueEPay 'it, Payment PageEonclic1EC,ec1out*s,o'PaymentPage78E >

***

>ody

>,tml

Deer dejar los campos marcados en gris si (uiere utilizar las pginasde interaccin con el tarjeta,aiente de #ig,to- y deer (uitar elcampo resaltado en rojo*

/n caso (ue (uiera utilizar las pginas de interaccin con eltarjeta,aiente de Hosted Payment Page deer utilizar el campomarcado en gris y (uitar el marcado en rojo

Para camiar el nomre del otn (ue aparecer en la pgina=nicamente deer reemplazar EPay 'it, #ig,to-E o EPay 'it,

Payment PageE* Por ejemplo.

7/25/2019 Guia Para La Integracion

11/18

input typeEuttonE %alueEPagarEonclic1EC,ec1out*s,o'#ig,to-78E >

input typeEuttonE %alueEPagarEonclic1EC,ec1out*s,o'PaymentPage78E >

Descripcin Campos ,!ligatorios

merc,ant. /s su n=mero de a)liacin* amount. /l monto total del pedido+ (ue se muestra al

tarjeta,aiente en la pgina de pago* 3i usted agrega cual(uierlRnea de detalles del artRculo o alguno de los montos del sutotal7order*item$mount+ order*s,ipping$ndHandling$mount8 ademsde order*amount+ entonces el total del pedido dee ser igual a lasuma de esos %alores*

o /ste campo dee conAormarse por n=meros del NGS y * yrepresentar un n=mero decimal %lido*

o Dee ser un n=mero mayor a N

o #a longitud del campo dee ser mayor o igual a 0 peromenor o igual a 0:*

currency. #a moneda (ue el tarjeta,aiente eligi para el pago+(ue dee e-presarse en el cdigo alAa I3O :20 ej* "3D+ 9;*

o /ste campo es de te-to deen ser may=sculas $GT

o #a longitud del campo dee ser igual a 5

description. /s una descripcin corta del contenido del pedido (uese muestra al tarjeta,aiente en la pgina de pago*

o Puede contener cual(uier tipo de caracteres

o #a longitud del campo dee ser mayor o igual a 0 peromenor o igual a 02

Id. ;=mero de identi)cacin de la transaccin.

o order*id. "n identi)cador =nico para distinguir las rdenescreadas* /ste %alor dee ser =nico para cada orden* /s un%alor opcional*

7/25/2019 Guia Para La Integracion

12/18

o Puede contener cual(uier tipo de carcter*

o #a longitud del campo dee ser mayor o igual a 0 peromenor o igual a :N

9erc,ant name. /l nomre de su negocio (ue se mostrar altarjeta,aiente en la pgina de pago*

o Puede contener cual(uier tipo de carcter

o #a longitud del campo dee ser mayor o igual a N peromenor o igual a :N

9erc,ant address. Direccin del negocio

"sted podr elegir si (uiere solicitar o no la inAormacin de Aacturacinal tarjeta,aiente al momento de realizar el pago y podr elegir entrelos campos de la siguiente "!# para personalizar la pgina de pago.

,ttps.>>secure*na*tnspayments*com>api>documentation>apiDocumentation>c,ec1out>%ersion>latest>Aunction>con)gure*,tmlUlocaleenL"3V-Lre(uestLinteraction

Para mayor personalizacin de la pgina de pago+ en la (ue el negociopodr agregar el logo 7=nicamente aparecer en la integracin (uemuestra la pgina de pago de Hosted Payment Page+ #ig,to- no

muestra logo8+ direccin del negocio+ etc* /l negocio podr utilizar elsiguiente cdigo para agregar estos elementos camiando =nicamentelos campos marcados en amarillo con la inAormacin de su negocio.

C,ec1out*con)gure7

merc,ant . KyourLmerc,antLidK+

order .

amount . Aunction 78 >>Dynamic calculation oA amount

return MN 2N

J+

currency . K9;K+

description. KOrdered goodsK+

id. Kuni(ueLorderLidK

J+

7/25/2019 Guia Para La Integracion

13/18

illing .

address.

street . K025 Customer 3treetK+

city . K9etropolisK+

postcodeTip . KSSSSSK+

statePro%ince. K;QK+

country . K"3$K

J

J+

interaction.

merc,ant .

name . KQour merc,ant nameK+

address.

line0. K2NN 3ample 3tK+

line2. K025: /-ample

7/25/2019 Guia Para La Integracion

14/18

customer/mail . KOP

7/25/2019 Guia Para La Integracion

15/18

0* 3olicite una sesin mediante la operacin Crear sesin de pago*#a solicitud dee incluir datos de pago y de interaccin+ asR comoinstrucciones de t&rmino* $ continuacin se muestra unAragmento curl de ejemplo para la operacin Crear sesin de

pago* /n este paso tami&n deer otener el $PI pass'ord7deer ingresarlo en el campo marcado en amarillo8+ para elloAa%or de consultar la guRa de otencin de $PI pass'ord*

curl ,ttps.>>secure*na*tnspayments*com>api>page>%ersion>2>pay Z

Gd EapiOperationC!/$

7/25/2019 Guia Para La Integracion

16/18

/l motor de pago en%Ra el resultado del pago en el parmetroresultIndicator+ (ue.

o

3e adjunta a la direccin "!# utilizada para regresar altarjeta,aiente al sitio de la tienda*

o 3e proporciona como parmetros de entrada a la Auncin

complete en la de%olucin de llamada*

"sted puede determinar si el pago se realiz correctamente o noal comparar los parmetros resultIndicator y successIndicator*"na coincidencia indica (ue el pago se realiz correctamente*

5* 3i se realiza correctamente+ deer presentar un recio de pagoal tarjeta,aiente en el sitio del negocio y deer actualizar susistema con los detalles del pago* Puede recuperar estos datosmediante la operacin !ecuperar pedido*

Para mayor inAormacin sore esta integracin Aa%or de consultar en la"!# en la seccin de Otener el resultado del pago y !etorno delpagador al sitio de la tienda.

,ttps.>>secure*na*tnspayments*com>api>documentation>integration?uidelines>,ostedPaymentPage>integration9odelHostedC,ec1out*,tmlUlocaleesL9

Para crear su sesin de pago en ;6P consultar.,ttps.>>secure*na*tnspayments*com>api>documentation>apiDocumentati

on>n%p>%ersion>latest>operation>3ession^5a^2NCreate^2NC,ec1out^2N3ession*,tmlUlocaleesL9

Para crear la sesin de pago en !/3< consultar.,ttps.>>secure*na*tnspayments*com>api>documentation>apiDocumentation>restGjson>%ersion>latest>operation>3ession^5a^2NCreate^2NC,ec1out^2N3ession*,tmlUlocaleesL9

'eporting .PI

https://secure.na.tnspayments.com/api/documentation/integrationGuidelines/hostedPaymentPage/integrationModelHostedCheckout.html?locale=es_MXhttps://secure.na.tnspayments.com/api/documentation/integrationGuidelines/hostedPaymentPage/integrationModelHostedCheckout.html?locale=es_MXhttps://secure.na.tnspayments.com/api/documentation/integrationGuidelines/hostedPaymentPage/integrationModelHostedCheckout.html?locale=es_MXhttps://secure.na.tnspayments.com/api/documentation/apiDocumentation/nvp/version/latest/operation/Session%3A%20Create%20Checkout%20Session.html?locale=es_MXhttps://secure.na.tnspayments.com/api/documentation/apiDocumentation/nvp/version/latest/operation/Session%3A%20Create%20Checkout%20Session.html?locale=es_MXhttps://secure.na.tnspayments.com/api/documentation/apiDocumentation/nvp/version/latest/operation/Session%3A%20Create%20Checkout%20Session.html?locale=es_MXhttps://secure.na.tnspayments.com/api/documentation/apiDocumentation/rest-json/version/latest/operation/Session%3A%20Create%20Checkout%20Session.html?locale=es_MXhttps://secure.na.tnspayments.com/api/documentation/apiDocumentation/rest-json/version/latest/operation/Session%3A%20Create%20Checkout%20Session.html?locale=es_MXhttps://secure.na.tnspayments.com/api/documentation/apiDocumentation/rest-json/version/latest/operation/Session%3A%20Create%20Checkout%20Session.html?locale=es_MXhttps://secure.na.tnspayments.com/api/documentation/integrationGuidelines/hostedPaymentPage/integrationModelHostedCheckout.html?locale=es_MXhttps://secure.na.tnspayments.com/api/documentation/integrationGuidelines/hostedPaymentPage/integrationModelHostedCheckout.html?locale=es_MXhttps://secure.na.tnspayments.com/api/documentation/integrationGuidelines/hostedPaymentPage/integrationModelHostedCheckout.html?locale=es_MXhttps://secure.na.tnspayments.com/api/documentation/apiDocumentation/nvp/version/latest/operation/Session%3A%20Create%20Checkout%20Session.html?locale=es_MXhttps://secure.na.tnspayments.com/api/documentation/apiDocumentation/nvp/version/latest/operation/Session%3A%20Create%20Checkout%20Session.html?locale=es_MXhttps://secure.na.tnspayments.com/api/documentation/apiDocumentation/nvp/version/latest/operation/Session%3A%20Create%20Checkout%20Session.html?locale=es_MXhttps://secure.na.tnspayments.com/api/documentation/apiDocumentation/rest-json/version/latest/operation/Session%3A%20Create%20Checkout%20Session.html?locale=es_MXhttps://secure.na.tnspayments.com/api/documentation/apiDocumentation/rest-json/version/latest/operation/Session%3A%20Create%20Checkout%20Session.html?locale=es_MXhttps://secure.na.tnspayments.com/api/documentation/apiDocumentation/rest-json/version/latest/operation/Session%3A%20Create%20Checkout%20Session.html?locale=es_MX

7/25/2019 Guia Para La Integracion

17/18

/l !eporting $PI oArece la posiilidad de programar y descargar reportesajustados* Para la creacin del !eporte $PI usted deer crear una "!#

integrada por los siguientes datos.

,ttps.>>secure*na*tnspayments*com>,istory>%ersion>0>merc,ant>SSSSSSS>transactionUtimeOA!ecord*start2N0:GN:G25

7/25/2019 Guia Para La Integracion

18/18

"sted podr elegir el lugar donde (uiere guardar el arc,i%o (ue sedescargar en Aormato C36 7estos arc,i%os se pueden arir en /-cel8 yaparecern los campos y las Aec,as (ue eligi*

Para mayor inAormacin sore este reporte y su automatizacin Aa%or de

ingresar a la siguiente "!#.,ttps.>>secure*na*tnspayments*com>api>documentation>integration?uidelines>supportedFeatures>pic1$dditionalFunctionality>reporting>reporting$PI*,tmlUlocaleesL9

https://secure.na.tnspayments.com/api/documentation/integrationGuidelines/supportedFeatures/pickAdditionalFunctionality/reporting/reportingAPI.html?locale=es_MXhttps://secure.na.tnspayments.com/api/documentation/integrationGuidelines/supportedFeatures/pickAdditionalFunctionality/reporting/reportingAPI.html?locale=es_MXhttps://secure.na.tnspayments.com/api/documentation/integrationGuidelines/supportedFeatures/pickAdditionalFunctionality/reporting/reportingAPI.html?locale=es_MXhttps://secure.na.tnspayments.com/api/documentation/integrationGuidelines/supportedFeatures/pickAdditionalFunctionality/reporting/reportingAPI.html?locale=es_MXhttps://secure.na.tnspayments.com/api/documentation/integrationGuidelines/supportedFeatures/pickAdditionalFunctionality/reporting/reportingAPI.html?locale=es_MXhttps://secure.na.tnspayments.com/api/documentation/integrationGuidelines/supportedFeatures/pickAdditionalFunctionality/reporting/reportingAPI.html?locale=es_MX