驴C贸mo Utilizarlo?

En las APIs de Netpay encontraras que dentro de las integraciones es necesario que se agregue este paso de seguridad utilizando la siguiente estructura dentro del objeto JSON

馃摌

Importante

Para poder simular una transacci贸n que pasa por 3DS es necesario en el campo de email enviar el correo: [email protected] y dentro de redirect3dsUri enviar la ruta en donde haremos la redirecci贸n una vez se realice el paso de 3DS, en este ejemplo enviamos https://netpay.mx

{
	"description": "Cargo de prueba",
	"source": "token_PovvKRyhNISspvuRXhKobReCcizMDoswDXhbCZrI",
	"paymentMethod": "card",
	"amount":300,
	"currency": "MXN",
	"billing": {
		"firstName": "Hector",
		"lastName": "Temich",
		"email": "[email protected]",
		"phone": "1234567890",
		"address": {
			"city": "Monterrey",
			"country": "MX",
			"postalCode": "93994",
			"state": "Nuevo Leon",
			"street1": "Calle",
			"street2": "Centro"
		},
		"merchantReferenceCode": "14500056"
	},
	"redirect3dsUri": "https://netpay.mx"
}

Response

La respuesta de ejecutar este cargo con el correo de [email protected] es la siguiente:

{
    "client": null,
    "source": "token_gGozdaVHDfQmJYIlcTIlAvCzCCcGIGZMrokagQKe",
    "amount": 300.0,
    "description": "Cargo de prueba",
    "status": "review",
    "transactionTokenId": "5b503957-d5b5-459a-94c0-3e1996d27dda",
    "redirect3dsUri": "https://netpay.mx",
    "returnUrl": "https://ecommerce.netpay.com.mx/gateway-ecommerce/v1/three-d-secure/paymenth-auth-enroll/5b503957-d5b5-459a-94c0-3e1996d27dda?webHook=https://netpay.mx",
    "paymentMethod": "card",
    "currency": "MXN",
    "createdAt": "2020-12-30T23:40:26.577+0000",
    "error": null,
    "installments": null,
    "ship": null,
    "paymentSource": {
        "cardDefault": false,
        "card": {
            "token": "token_gGozdaVHDfQmJYIlcTIlAvCzCCcGIGZMrokagQKe",
            "expYear": "21",
            "expMonth": "08",
            "lastFourDigits": "0002",
            "cardHolderName": "John Doe",
            "brand": "visa",
            "deviceFingerPrint": "hdyAWr63jfvf0nnfvyen",
            "ipAddress": "254.254.254.1",
            "bank": "Test bank",
            "type": "debit",
            "country": "unknown",
            "scheme": "unknown",
            "cardPrefix": "400000"
        },
        "source": "token_gGozdaVHDfQmJYIlcTIlAvCzCCcGIGZMrokagQKe",
        "type": "card"
    },
    "billing": {
        "firstName": "Hector",
        "lastName": "Temich",
        "email": "[email protected]",
        "phone": "1234567890",
        "ipAddress": "254.254.254.1",
        "merchantReferenceCode": "14500056",
        "address": {
            "city": "Monterrey",
            "country": "MX",
            "postalCode": "93994",
            "state": "Nuevo Leon",
            "street1": "Calle",
            "street2": "Centro"
        }
    }
}

Redireccion

Es necesario cargar la url que viene en la secci贸n returnUrl la cual nos mandara a la pantalla de validaci贸n bancaria y as铆 ejecutar este paso de seguridad, en este caso la url es: https://ecommerce.netpay.com.mx/gateway-ecommerce/v1/three-d-secure/paymenth-auth-enroll/5b503957-d5b5-459a-94c0-3e1996d27dda?webHook=https://netpay.mx

Como pueden ver en la secci贸n del webHook viene la direcci贸n que nosotros indicamos en la petici贸n a donde mandara la respuesta de este paso del 3DS, al entrar al esta URL debera verse asi:

382

Al poner de forma exitosa, err贸nea o no ingresar la clave en esta pantalla necesitaremos consultar el estatus de la transacci贸n para poder saber cual es su status ejecutando nuestro endpoint de status https://ecommerce.netpay.com.mx/gateway-ecommerce/v3/transactions/{{transactionTokenId}} donde mandaremos el transactionTokenId como par谩metro en la URL y dentro de las posibles respuestas se encuentran

Aceptado

Esto nos indica que la transacci贸n puede ser cobrada ya que paso el 3DS de forma exitosa

馃毀

Importante

Esto no indica que la el cargo ya se realizo para poder realizar el cargo es necesario ejecutar en endpoint https://ecommerce.netpay.com.mx/gateway-ecommerce/v3/charges/{{transactionTokenId}}/confirm con el cual se realizara el cobro de la transacci贸n con toda seguridad.

"status": "CHARGEABLE"

Rechazado

Esta respuesta ocurre cuando al momento de poner la contrase帽a se ingresa de forma incorrecta

馃摌

Importante

Para poder simular este rechazo aparte de utilizar el correo [email protected] es necesario que la tarjeta tokenizada en la transacci贸n sea: 4000000000000010 ya que esta esta preparada para simular este paso en las pruebas.

"status": "FAILED"

En espera

Se presenta cuando el cliente al momento de entrar a la pantalla de 3DS abandona la pantalla o nunca ingresa alg煤n c贸digo de validaci贸n.

"status": "WAIT_THREEDS"

Al validar estos posibles casos y la ejecuci贸n de los mismos est茅n implementados en el sistema puedes tener la seguridad de contar con esta excelente herramienta anti fraude.