[PAT] Tarjetas

Esta notificación se envía al activationWebhook cuando un cliente enrola exitosamente una tarjeta de crédito, débito o prepago como medio de pago de su mandato.

Métodos de pago cubiertos:

Método	paymentMethod.id
Tarjeta de Crédito	3
Tarjeta de Débito	4
Tarjeta de Prepago	11

Payload de ejemplo

JSON

{
  "businessPartner": {
    "businessPartnerId": "2",
    "identificationDocument": {
      "documentType": "RUT",
      "documentNumber": 77209349,
      "verificationNumber": "7"
    }
  },
  "customer": {
    "userId": "19000",
    "identificationDocument": {
      "documentType": "RUT",
      "documentNumber": 20296421,
      "verificationNumber": "4"
    },
    "internalUserId": 1527
  },
  "product": {
    "type": "MANDATE",
    "description": "Enrola la tarjeta correctamente",
    "dateTime": "2024-04-12T16:10:50.977Z",
    "internalId": 3688,
    "id": "benja1",
    "metadata": {
      "key1": "value"
    },
    "state": {
      "id": 1,
      "name": "ACTIVA"
    },
    "serviceId": "2Z3688ZM"
  },
  "paymentMethod": {
    "card": {
      "last4digits": "6623",
      "brand": {
        "id": 2,
        "name": "VISA"
      }
    },
    "description": "TARJETA DE CRÉDITO",
    "id": 3
  },
  "subscription": {
    "internalId": 527,
    "externalId": "01ab73eb30632c5c16133224d70c3b0d8dfbdd9b2271a91786f6769a971aab58"
  },
  "signature": "JGUy6pUuXf9okO0/swBv4kkSwj6TOouGSZ7u81jWY/w="
}

Descripción de campos

businessPartner

Información del comercio Forpay asociado al mandato.

Campo	Tipo	Descripción
businessPartnerId	string	ID interno del comercio en Forpay
identificationDocument.documentType	string	Tipo de documento (siempre "RUT" en Chile)
identificationDocument.documentNumber	number	Número de RUT sin dígito verificador
identificationDocument.verificationNumber	string	Dígito verificador del RUT

customer

Información del cliente que enroló el medio de pago.

Campo	Tipo	Descripción
userId	string	ID de usuario en el sistema del comercio
internalUserId	number	ID interno asignado por Forpay al usuario
identificationDocument.documentType	string	Tipo de documento ("RUT")
identificationDocument.documentNumber	number	RUT del cliente sin dígito verificador
identificationDocument.verificationNumber	string	Dígito verificador del RUT del cliente

product

Información del mandato (compromiso de pago).

Campo	Tipo	Descripción
type	string	Siempre "MANDATE"
description	string	Descripción del evento de activación
dateTime	string	Fecha y hora del evento (ISO 8601)
internalId	number	ID interno del mandato en Forpay
id	string / null	ID externo del mandato (definido por el comercio)
metadata	object	Datos adicionales enviados al crear el mandato
state.id	number	ID del estado del compromiso
state.name	string	Nombre del estado (ej. "ACTIVA")
serviceId	string / null	ID de servicio Forpay

paymentMethod

Información del medio de pago enrolado.

Campo	Tipo	Descripción
id	number	ID del método de pago (3 = Crédito, 4 = Débito, 11 = Prepago)
description	string	Descripción del método (ej. "TARJETA DE CRÉDITO")
card.last4digits	string	Últimos 4 dígitos de la tarjeta
card.brand.id	number	ID de la marca de la tarjeta
card.brand.name	string	Nombre de la marca (ej. "VISA", "MASTERCARD")

subscription

Identificadores de la suscripción creada en el procesador de pagos.

Campo	Tipo	Descripción
internalId	number	ID interno de la suscripción en Forpay
externalId	string	ID externo de la suscripción en el procesador (ej. Transbank Oneclick)

signature

Firma HMAC-SHA256 en Base64 para validar el origen del mensaje. Ver Verificación HMAC para el detalle de los campos a concatenar.