guia para la integracion
Post on 26-Feb-2018
252 Views
Preview:
TRANSCRIPT
-
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
top related