Getnet DocsGetnet Docs

Verificar una Tarjeta

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page
Connect to CursorUse these docs in CursorConnect to VS CodeUse these docs in VS Code

Procese una transacción de pago de importe cero únicamente para validar la tarjeta. Esta guía le acompaña en cada paso del uso de la Global API de Getnet para este flujo común de comercio electrónico.

Requisitos

Antes de seguir los pasos, necesita:

  • Crear su cuenta contactando con el equipo de Soporte de Integración para obtener sus credenciales de API client_id y client_secret.
  • Generar su token con sus credenciales utilizando el endpoint de Authentication.

Getnet proporciona una Postman Collection para ayudarle a replicar estos casos de uso de forma local. También puede probar la API en sandbox utilizando la API Reference disponible en la documentación.

Especificidades de los Casos de Uso

Al integrar cualquier solución de Getnet, se aplican requisitos específicos de cada mercado. Asegúrese de revisar los recursos siguientes antes de pasar a producción:

También puede utilizar tarjetas de prueba para simular escenarios específicos. Puede encontrar más información sobre los requisitos de cada país en la sección Developer Resources de la documentación de Getnet.

Step 1: Verificando una tarjeta

Un pago de importe cero comienza con la autorización. Este paso valida al cliente y los datos de la tarjeta. Utilice el endpoint de verificación de tarjeta para iniciar la transacción.

La siguiente tabla muestra los campos que debe enviar:

AtributoTipoDescriçãoExemplo
number_tokenStringNúmero de tarjeta tokenizado.dfe05208b105578c070f806c80abd3a
brandStringMarca de la tarjeta.Mastercard
cardholder_nameStringNombre del titular impreso en la tarjeta.JOAO DA SILVA
expiration_monthStringMes de expiración de la tarjeta (dos dígitos).28
expiration_yearStringAño de expiración de la tarjeta (dos dígitos).12
security_codeStringCódigo de seguridad. CVV o CVC.123

El siguiente bloque de código muestra un ejemplo de solicitud y respuesta para autorizar un pago:

curl --request POST \
  --url https://api.pre.globalgetnet.com/dpm/cofre-gw-proxy/v1/cards/verification \
  --header 'authorization: Bearer ' \
  --header 'content-type: application/json' \
  --header 'x-seller-id: 54f88e68-7764-4e87-8830-756b1e2c02f8' \
  --header 'x-transaction-channel-entry: XX' \
  --data '{
  "number_token": "dfe05208b105578c070f806c80abd3a",
  "brand": "Mastercard",
  "cardholder_name": "JOAO DA SILVA",
  "expiration_month": "12",
  "expiration_year": "28",
  "security_code": "123"
}'

Ejemplo de respuesta:

{
  "status": "VERIFIED",
  "verification_id": "ae267804-503c-4163-b1b1-f5da5120b74e",
  "authorization_code": "6964722471672911",
  "transaction_id": "1002217281190421"
}

El sistema de Getnet envía automáticamente una transacción interna de importe cero junto con los datos de la tarjeta, lo que permite al emisor validar la existencia y elegibilidad de la tarjeta. Tras una validación exitosa, puede crear pagos.

Esta es una verificación sin transacción financiera, en la que no se acredita ningún importe en la tarjeta.

Próximos Pasos

Puede explorar más funcionalidades de la Global API de Getnet: