Skip to main content

​
Endpoint

POST /v1/send/wallet

​
Headers

HeaderValor
X-API-KeyTu API key
Content-Typeapplication/json

​
Apple Wallet

​
Body

{
  "pass_type": "apple",
  "pass_data": {
    "serial_number":     "SN-001",
    "organization_name": "Mi Empresa",
    "description":       "Membresía Premium",
    "icon_base64":       ""
  }
}

​
Campos de pass_data

CampoTipoRequeridoDescripción
serial_numberstring✅Identificador único del pase
organization_namestring✅Nombre de la organización que aparece en el pase
descriptionstring✅Descripción del pase
icon_base64string—Ícono PNG en base64. Si está vacío, usa un placeholder 1×1

​
Respuesta

{
  "job_id": "...",
  "status": "success",
  "result": {
    "pkpass_base64": "UEsDBBQAAA..."
  }
}
Sirve el archivo decodificado con Content-Type: application/vnd.apple.pkpass.

​
Google Wallet

​
Body

{
  "pass_type": "google",
  "pass_data": {
    "class_id":    "3388000000012345678.membresiaGold",
    "object_id":   "3388000000012345678.usuario-001",
    "object_data": {
      "id":      "3388000000012345678.usuario-001",
      "classId": "3388000000012345678.membresiaGold",
      "state":   "ACTIVE"
    }
  }
}

​
Campos de pass_data

CampoTipoRequeridoDescripción
class_idstring✅issuer_id.nombre_clase
object_idstring✅issuer_id.id_unico_objeto
object_dataobject✅Payload del Generic Object (ver documentación Google)

​
Respuesta

{
  "job_id": "...",
  "status": "success",
  "result": {
    "save_link": "https://pay.google.com/gp/v/save/<jwt>"
  }
}
Comparte el save_link con el usuario para que lo agregue a Google Wallet.

​
Errores

CódigoCausa
400pass_type inválido o pass_data faltante
401API key inválida
403Canal wallet no habilitado para tu tenant
500Certificado Apple/.p12 o Service Account Google no configurados