- Principal
- Modelos de integracion
- Funcionalidades TPV Virtual
- Realización pruebas
- Parámetros de Entrada-Salida
- Códigos de respuesta
- Descargas y documentación
Apple Pay
Enrolamiento del Comercio con Apple Pay
Como primer requisito,el comercio deberá registrarse en la plataforma de Apple Pay. Como resultado, generará un identificador de comercio (merchantId) y un certificado que se utilizará para el posterior desencriptado de los datos del medio de pago.
Acceder a la Consola de Apple, crear un Merchant-Id que identifique al Comercio. Para registrar un Merchant ID:
1. Seleccionar Certificates, Identifiers & Profiles.
2. Debajo de los identificadores, selecciona Merchant IDs.
3. Clic en el botón de añadir (+) en la esquina superior derecha.
4. Escribe una descripción y un identificador, y haz clic en continuar.
5. Revise la configuración y haga clic en Registrarse.
6. Haga clic en Listo.
Una vez generado el Merchant Id, es necesario generar un Certificado CSR a partir de una clave privada. Dicha clave Privada será la que el comercio deba configurar en el Portal de administración del TPV Virtual. A continuación se establece el procedimiento para la generación del certificado CSR:
1. En el centro de miembros, selecciona Certificates, Identifiers & Profiles.
2. Debajo de los identificadores, selecciona Merchant IDs.
3. Selecciona un Merchant ID de la lista y haz clic en Editar.
4. En la sección Certificados de procesamiento de pagos, haga clic en Crear certificado. Siga las instrucciones para obtener o generar su solicitud de firma de certificado (CSR) y haga clic en Continuar.
5. Haga clic en Elegir archivo, seleccione su CSR y haga clic en Generar.
6. Descargue el certificado haciendo clic en Descargar y haga clic en Listo.
**En la integración con el TPV Virtual únicamente es necesario registrar la clave privada generada para la solicitud del certificado CSR.
A continuación, se muestra de forma detallada las opciones para generar el certificado CSR:
**Esta integración sólo se puede realizar en el entorno de producción del TPV Virtual.
a) Herramientas de línea de comando
OpenSSL
• Generar par de claves en un archivo de claves
openssl ecparam -genkey -name prime256v1 -out ecckey.key
• Generar CSR a partir del par de claves en el archivo de claves
openssl req -new -sha256 -key ecckey.key -out ecccertreq.csr -subj /CN = www.midominio.com
Keytool
• Generar par de claves en un archivo pkcs12
keytool -genkeypair -keyalg EC -keystore ecckeystore.p12 -storetype pkcs12 -keysize 256 -alias ecckeyname -dname CN = www.midominio.com
• Generar CSR a partir del par de claves en el archivo pkcs12
keytool -certreq -sigalg SHA256withECDSA -alias ecckeyname -file ecccertreq.csr -keystore ecckeystore.p12 -storetype pkcs12
b) Keychain Access (solo Mac)
(i) En la carpeta Aplicaciones en su Mac, abra la carpeta Utilidades y ejecute:
Keychain Access
(ii) En el menú desplegable Acceso al llavero, seleccione Acceso al llavero>Asistente de certificados> Solicitar un certificado de una autoridad de certificación
(iii) En la ventana Información del certificado, ingrese la siguiente información:
• En la dirección de correo electrónico del usuario presentada, ingrese su dirección de correo electrónico
• En el campo Nombre común, cree un nombre para su clave privada (por ejemplo, John Doe Dev Key)
• El campo Dirección de correo electrónico de CA debe dejarse vacío
• En el grupo " Request is", seleccione la opción "Saved to disk"
• Seleccione "Let me specify key pair information"
(iv) Haga clic en Continuar dentro de Acceso a llavero y seleccione la ubicación del archivo
(v) Establezca la información del par de claves en lo siguiente:
• Algoritmo: ECC
• Tamaño de clave: 256 bits
(vi) Haga clic en Continuar dentro del Acceso a Llaveros para completar el proceso de generación de CSR
Integración con el TPV Virtual
En primer lugar, debes solicitar el alta del método de pago a tu entidad bancaria.
Una vez activado, en la operación de autorización enviada al TPV Virtual, se deben añadir los siguientes parámetros adicionales:
Parámetro | long/tipo | Descripción |
---|---|---|
DS_XPAYDATA | 10000 / A-N | Obligatorio. Campo en el que se incluyen los datos del enviados por el xPay en formato Hexadecimal |
DS_XPAYTYPE | 10 / A-N | Obligatorio. Valor fijo "Apple" |
DS_XPAYORIGEN | 5 / A-N | Obligatorio
|
A continuación se incluye un ejemplo de petición al TPV Virtual
{
"DS_MERCHANT_AMOUNT": "145",
"DS_MERCHANT_CURRENCY": "978",
"DS_MERCHANT_MERCHANTCODE": "999008881",
"DS_MERCHANT_ORDER": "1446068581",
"DS_MERCHANT_TERMINAL": "1",
"DS_MERCHANT_TRANSACTIONTYPE": "0",
"DS_XPAYDATA":"7B2276657273696F6E223A2245435F7631222C2264617461223A224875317531503941437030594A53316C2B57746B6D63306268575448385578554842596174466D36555836345159785966624D4846757964674D4136414B465556676C693869746C462B7965495A704532572B686E6E796A56446F74714644472F483850425579526A737847436F782B4B71726741756A504B314656557859544830472F7A427862763556506174316C34454E7132635A6D6A686251377341504C7A39584E415039756C3463384668697834652F473848447A6A5139307770616A6D4E57342B4A71444B72516F7A504B4B6B5672366161727276512B4746594230594976447458744251586A57494E424B774B524B4E524A6B532F6445507A736770456245684374333336426E4D53493555306C7131466B3873724676412B554B526B77466572446E617479465A4F764A6B5942624D424C30434531726C6C6842466E6670595A6F70772B764652725A356749413531484E2F52486E6D4F4C313839767A6B30652F50514F37412B2B54754F…..",
"DS_XPAYTYPE":"Apple",
"DS_XPAYORIGEN":"InApp"
}