1. Autenticación
Para acceder a los servicios de Pago TIC, es necesario obtener un TOKEN de autenticación utilizando las credenciales proporcionadas por el equipo técnico (usuario y contraseña). Este token permitirá realizar solicitudes seguras dentro del sistema.
curl --location 'https://a.paypertic.com/auth/realms/entidades/protocol/openid-connect/token' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'username=USUARIO' \ --data-urlencode 'password=CONTRASEÑA' \ --data-urlencode 'grant_type=password' \ --data-urlencode 'client_id=16465308-1844-4abe-abe6-f184149ee740' \ --data-urlencode 'client_secret=a2d03fa3-f6c4-45e5-9792-dc0d8b51a25c'
2. Creación del Formulario de Suscripción
Una vez obtenido el TOKEN, se debe enviar una solicitud de suscripción para generar el formulario. Es fundamental indicar una URL válida en el campo notification_url, ya que ahí se recibirán las actualizaciones sobre el estado de la suscripción.
--header 'Content-Type: application/json' \
--data-raw '{
"type": "subscription",
"currency_id": "ARS",
"recurrence":"monthly",
"start_in_current_period":false,
"due_day":"20",
"last_due_day":"2025-03-30T00:00:00-0300",
"start_date":"2025-03-01T00:00:00-0300",
"notification_url":"https://implementacionespagotic.free.beeceptor.com",
"detail":
{
"external_reference": "987987",
"concept_id":"987",
"concept_description":"prueba suscripción",
"amount":2000
},
"payer": {
"name": "Lucas Campos",
"email": "lucasc@pagotic.com",
"identification": {
"type":"DNI_ARG",
"number":"11222333",
"country":"ARG"
}
}
}'
3. Formulario de Suscripción
Como respuesta a la solicitud, se recibirá un JSON que incluirá el campo form_url, el cual contiene la URL del formulario de suscripción. Este formulario puede integrarse mediante un iframe, donde el usuario deberá informar con qué medio de pago desea adherirse al débito recurrente
Se podrá identificar cada Suscripción mediante el dato ID
En este ejemplo la suscripción tendrá el siguiente identificador:
"id": "af991595-c886-43d6-881a-6304e60b327f"
Respuesta a la solicitud de suscripción
{
"type": "subscription",
"validation": false,
"review": false,
"source": {
"id": "a08177c4-2266-4ddc-b858-2db63339b079",
"name": "lucasm",
"type": "operator"
},
"id": "af991595-c886-43d6-881a-6304e60b327f",
"collector_id": "2661",
"collector_detail": {
"name": "Pago TIC - DEMO"
},
"notification_url": "https://implementacionespagotic.free.beeceptor.com",
"form_url": "https://servicios.paypertic.com/formularios/v2/suscripciones/af991595-c886-43d6-881a-6304e60b327f",
"detail": {
"amount": 2000.0,
"external_reference": "987987",
"concept_id": "987",
"concept_description": "prueba suscripción"
},
"currency_id": "ARS",
"payer": {
"name": "lucas campos",
"email": "lucasc@pagotic.com",
"identification": {
"type": "DNI_ARG",
"number": "11222333",
"country": "ARG"
}
},
"amount": 2000.0,
"status": "pending",
"request_date": "2025-02-21T22:20:06+0000",
"due_day": 20,
"last_update_date": "2025-02-21T22:20:06+0000",
"recurrence": "monthly",
"periods": 0,
"created_payments": 0,
"start_date": "2025-03-01T03:00:00+0000"
}
Ejemplo del Formulario de Suscripción
4. Suscripción Activa
Una vez informado el medio de pago, el usuario podrá visualizar una pantalla que le informa que la suscripción fue exitosa. Durante este proceso, el estado del formulario cambiará de pending a active, durante ese cambio, se enviará una notificación al endpoint configurado para actualizaciones.
Ejemplo de Notificación de suscripción Activa:
{
"type" : "subscription",
"validation" : false,
"review" : false,
"source" : {
"id" : "9b78bf3c-feff-4b5b-b4ab-52a450aa74e5",
"name" : "paypertic-api-forms",
"type" : "system"
},
"notifications" : [ {
"id" : "581cda98-78b2-4a93-979f-1edb7caef4ec",
"type" : "subscription",
"action" : "subscription.retry",
"date" : "2025-02-21T22:20:06+0000"
} ],
"id" : "af991595-c886-43d6-881a-6304e60b327f",
"collector_id" : "2661",
"collector_detail" : {
"name" : "Pago TIC - DEMO"
},
"notification_url" : "https://implementacionespagotic.free.beeceptor.com",
"form_url" : "https://servicios.paypertic.com/formularios/v2/suscripciones/af991595-c886-43d6-881a-6304e60b327f",
"detail" : {
"amount" : 2000.0,
"external_reference" : "987987",
"concept_id" : "987",
"concept_description" : "prueba suscripción"
},
"currency_id" : "ARS",
"payment_method" : {
"media_payment_id" : 9,
"media_payment_detail" : "VISA CREDIT",
"last_four_digits" : "0010",
"first_six_digits" : "450799"
},
"payer" : {
"name" : "lucas campos",
"email" : "lucasc@pagotic.com",
"identification" : {
"type" : "DNI_ARG",
"number" : "11222333",
"country" : "ARG"
}
},
"amount" : 2000.0,
"status" : "active",
"request_date" : "2025-02-21T22:20:06+0000",
"due_day" : 20,
"last_update_date" : "2025-02-21T22:29:22+0000",
"recurrence" : "monthly",
"periods" : 0,
"created_payments" : 0,
"start_date" : "2025-03-01T03:00:00+0000",
"collector_notifications" : [ {
"url" : "https://implementacionespagotic.free.beeceptor.com",
"response" : 200,
"status" : "pending",
"original_request" : "2025-02-21T22:20:06+0000",
"last_retry" : "2025-02-21T22:20:06+0000",
"retry_count" : 0
} ]
}
5. Modificación del Valor de la Suscripción
En caso de querer modificar el monto de la suscripción, se deberá utilizar el siguiente método
curl --location --request PUT 'https://api.paypertic.com/suscripciones//[ID_DE_SUSCRIPCION]' \
--header 'Cache-Control: no-cache' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer TOKEN' \
--data '{
"detail": {
"amount": 100
}
}'
Es importante aclarar que en caso de haber cobros en curso, estos no se verán afectados por este cambio y serán debitados con el monto original.
En dicho caso, el nuevo valor de la suscripción, comenzará a cobrarse a partir del siguiente periodo