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
} |