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
  • InApp - Si la integración es sobre una App móvil
  • WEB - Si la integración es Web

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"
}