AUTENTIFICACIÓN:
Para utilizar los servicios de la API de PagoTic deberán, en primer lugar, obtener el TOKEN mediante el método POST con las credenciales enviadas por el ejecutivo de cuenta.
Curl Autentificación curl --location --request POST '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=PASSWORD' \ --data-urlencode 'grant_type=password' \ --data-urlencode 'client_id=16465308-1844-4abe-abe6-f184149ee740' \ --data-urlencode 'client_secret=a2d03fa3-f6c4-45e5-9792-dc0d8b51a25c'
CREACIÓN DE FORMULARIO PAGAR - ADHERIR
Una vez obtenido el Token, nuevamente mediante el método POST se deberá crear el pago para obtener el formulario donde el pagador podrá pagar y adherirse al débito recurrente
Curl Crear Pago
curl --location --request POST 'https://api.paypertic.com/pagos' \
--header 'Authorization: Bearer TOKEN' \
--header 'Cache-Control: no-cache' \
--header 'Content-Type: application/json' \
--data-raw '{
"currency_id": "ARS",
"external_transaction_id": 1627606677,
"due_date": "2021-08-29T09:05:29-0300",
"notification_url":"URL_NOTIFICACIONES",
"details": [
{
"external_reference": "REFERENCIA INTERNA DEL PAGO",
"concept_id": "ID DEL CONCEPTO",
"concept_description": "pago de prueba",
"amount": 10
}
],
"payer": {
"name": "NOMBRE DEL PAGADOR",
"email": "MAIL DEL PAGADOR",
"identification": {
"type": "DNI_ARG",
"number": "35140275",
"country": "ARG"
}
}
}'
Más Detalles de Como crear un pago
Al realizar el request, la respuesta obtenida mostrará el campo “form_url”
donde estará la URL al formulario de pago donde el pagador deberá ingresar su medio de pago.
Respuesta al pedido de creacion de pago
{
"validation": false,
"review": false,
"version": "610344cd59ced51500dd9ebb",
"id": "8d7774bb-5a2a-476a-8749-ca126a02b5a8",
"external_transaction_id": "1627604173",
"form_url": "https://servicios.paypertic.com/formularios/v2/pagos/8d7774bb-5a2a-476a-8749",
"details": [
{
"amount": 10.0,
"external_reference": "987987",
"concept_id": "987",
"concept_description": "pago de prueba"
}
],
"currency_id": "ARS",
"payer": {
"name": "lucas prueba",
"email": "lucasm@pagotic.com",
"identification": {
"type": "DNI_ARG",
"number": "11222333",
"country": "ARG"
}
},
"final_amount": 10.0,
"status": "pending",
"request_date": "2021-07-30T00:16:13+0000",
"due_date": "2021-08-29T12:05:29+0000",
"last_due_date": "2021-08-29T12:05:29+0000",
"last_update_date": "2021-07-30T00:16:13+0000",
}
Formulario de Pago
Dentro del formulario de pago, el contribuyente tendrá la opción de pagar mediante la modalidad online o bien pagar y dejar adherido su medio de pago para futuros pagos que la entidad necesite debitarle.
Recomendamos integrar el servicio de Webhooks para recibir una notificación en cuanto el contribuyente realice el pago o bien el pago + adhesión.
En caso de que el contribuyente pida la baja de su adhesión, también recibirán un mensaje con la actualización de estado de la adhesión
Notificación de Pago + ID Adhesión / Suscripcion
{
"id": "aecb2105-1c67-4569-b79f-9ad8d4572d70",
"external_transaction_id": "1627612238",
"form_url": "https://servicios.paypertic.com/formularios/v2/pagos/aecb2105-1c67-4569-b79f",
"details": [
{
"amount": 10.0,
"external_reference": "987987",
"concept_id": "987",
"concept_description": "Prueba de theme"
}
],
"currency_id": "ARS",
"payment_methods": [
{
"type": "online",
"amount": 10.0,
"final_amount": 10.0,
"media_payment_id": 9,
"media_payment_detail": "VISA CREDIT",
"last_four_digits": "0010",
"first_six_digits": "450799",
"installments": 1,
"authorization_code": "021469",
"payment_method_id": 0,
"currency_id": "ARS"
}
],
"payer": {
"id": "a2f486cc-249b-4654-bb51-f347f52c4b0b",
"name": "lucas prueba",
"email": "lucasm@pagotic.com",
"identification": {
"type": "DNI_ARG",
"number": "11222333",
"country": "ARG"
}
},
"final_amount": 10.0,
"status": "approved",
"status_detail": "APROBADA - Autorizada - MOP GPAY: -1 - Aprobada",
"request_date": "2021-07-30T02:30:38+0000",
"due_date": "2021-08-29T12:05:29+0000",
"last_due_date": "2021-08-29T12:05:29+0000",
"process_date": "2021-07-30T02:31:16+0000",
"paid_date": "2021-07-30T02:31:14+0000",
"accreditation_date": "2021-09-01T02:31:14+0000",
"last_update_date": "2021-07-30T02:31:18+0000",
"metadata": {
"subscription_request": [
{
"subscription_id": "5f815711-456e-4a12-b1fb-c190b0ea3b49",
"status_code": 200
}
]
}
Junto a la confirmación de pago, dentro del campo metadata, se obtendrá el valor “subcription_id” que utilizaremos para identificar la adhesión del contribuyente para luego generarle pagos con un método POST cada vez que sea necesario realizarle un débito.
curl --location --request POST 'https://api.paypertic.com/suscripciones/adhesion/{subscription_id}/pago' \
--header 'Authorization: Bearer TOKEN' \
--header 'Cache-Control: no-cache' \
--header 'Content-Type: application/json' \
--data-raw '{
"currency_id": "ARS",
"external_transaction_id": 1627612787,
"due_date":"2021-04-30T09:05:29-0300",
"details": [
{
"external_reference": "987987",
"concept_id":"50",
"concept_description":"Prueba cobro adhesión",
"amount": 200
}]
Nuevamente recomendamos integrar el servicio de adhesiones, para estar en constante comunicación con los cambios de estado del débito en proceso
Una vez creado el pago recibirán un response con los datos del pago generado.
Y una vez procesado el pago recibirán la aprobación o rechazo via webhooks
{
"type": "debit",
"validation": false,
"review": false,
"version": "61200db4fec42551c78be00f",
"id": "5ccd2448-4fbd-4be8-9036-83aba906259e",
"external_transaction_id": "1629490613",
"collector_id": "999",
"collector_detail": {
"name": "PRUEBA",
"public_email": "test@pagotic.com"
},
"form_url": "https://servicios.paypertic.com/formularios/v2/pagos/5ccd2448-4fbd-4be8-9036-83aba906259e",
"details": [
{
"amount": 200.0,
"external_reference": "987987",
"concept_id": "50",
"concept_description": "Prueba cobro adhesion"
}
],
"currency_id": "ARS",
"payment_methods": [
{
"type": "debit",
"amount": 200.0,
"final_amount": 200.0,
"media_payment_id": 9,
"media_payment_detail": "VISA CREDIT",
"last_four_digits": "0010",
"first_six_digits": "450799",
"gateway": {
"status": "issued",
"establishment_number": "PRUEBA-DA",
"transaction_id": "97bc27391b2fc6b9b7cf6ad34f98034a2ceeb72011ac2a33b258fab297c9fcbd",
"ppt_owner": true,
"status_detail": "Payment method issued"
},
"payment_method_id": 0,
"currency_id": "ARS"
}
],
"payer": {
"name": "lucas prueba",
"email": "lucasm@paypertic.com",
"identification": {
"type": "DNI_ARG",
"number": "11222333",
"country": "ARG"
}
},
"final_amount": 200.0,
"status": "issued",
"status_detail": "Payment method issued",
"request_date": "2021-08-20T20:16:52+0000",
"due_date": "2021-08-30T12:05:29+0000",
"last_due_date": "2021-08-30T12:05:29+0000",
"process_date": "2021-08-20T20:16:53+0000",
"last_update_date": "2021-08-20T20:16:53+0000",
},
"by_subscription": "5a9bad13-f237-431a-9d87-18d097f0346e",
"last_modified": true
}
Configuraciones adicionales necesarias para Pagar y Suscribir
En caso de querer trabajar con suscripciones, deberá informarle al equipo de implementaciones los siguientes parametros para las recurrencias
Descripción | Tipo | Valor |
|---|---|---|
| Configuración para habilitar pagar y suscribir | BOOLEAN | Si / No |
| Configuración para poner fecha de vencimiento para pagar y suscribir | INTEGER | Unicamente el dia del mes |
| Configuración para poner última fecha de vencimiento para pagar y suscribir | INTEGER | Unicamente el dia del mes |
| Configuración para habilitar recurrencia para pagar y suscribir | STRING | weekly / monthly / yearly |
| Configuración para validar pagar y suscribir | BOOLEAN | Si / No |
| Configuración para habilitar review en pagar y suscribir | BOOLEAN | Si / No |
| Configuración para determinar tipo de pagar y suscribir | STRING | subscription / adhesion |