Pagos 2.0 - Documentación de API

Introducción

El presente documento describe los endpoints de la API de TotalCoin para la registración de pagos desde sistemas externos.

Autenticación

El control de acceso a la API se realiza a través del estándar OAuth 2.0 con Bearer Tokens.

Endpoint

Request

{
    "username": "",
    "password": ""
}

Response (HTTP 200)

{
    "token": "",
    "expires_in": 3600
}

Errores Comunes

Realizar Pago

Llamando a este endpoint es posible realizar un pago a un CBU, CVU o un Alias del sistema bancario Argentino.

Endpoint

Headers

Request

{
    "alias": "",
    "cbucvu": "",
    "cuitcuil": "",
    "amount": 0,
    "reference": "",
    "notificationUrl": ""
}   
                

Response (HTTP 200)

{
    "id": ""
}

Errores Comunes

Notificación de Resultado (Callback)

Una vez realizada la transacción, se notificará el resultado a la URL informada en el request de Realizar Pago (campo notificationUrl).
Cabe aclarar que solo se notificaran estados finales (los mismos seran listados en esta seccion).

Headers

Body

{
  "body": {
    "id": "",
    "status": ""
  },
  "securityKey": ""
}

Seguridad en la llamada al webhook. Cálculo del Hash

Adicionalmente a los mecanismos de seguridad propuestos por el Cliente (por ejemplo IP Whitelisting) Como metodo de Seguridad extra Totalcoin envia un Authentication header con un SHA256 Hash, el mismo es usado para verificar que el mensaje fue enviado por Totalcoin y se lo utiliza de la siguiente forma:

1. Al JSON recibido, agregar al campo securityKey la clave privada proporcionada por Totalcoin usando un canal seguro
2. Convertir el JSON completo a minúsculas
3. Calcular el hash con SHA256

Ejemplo:

Request recibido en el webhook:

Authorization: 4e36de37b87010d301e4b3a9046befe24ef253a98746f1d43998f29c31e188d4
{"Body":{"Id":"E6451028-84CE-4FA4-B3BC-335972BEBF0A","Status":"Failed"},"Securitykey":""}


Clave privada: 09B4ET8C4EB24S8ABTA8B8A  (otorgada por Totalcoin)

JSON con el campo SecurityKey:
{
    "Body":{
        "Id":"E6451028-84CE-4FA4-B3BC-335972BEBF0A",
        "Status":"Failed"
    },
    "Securitykey":"09B4ET8C4EB24S8ABTA8B8A"
}

JSON convertido a minúsculas:
{"body":{"id":"e6451028-84ce-4fa4-b3bc-335972bebf0a","status":"failed"},"securitykey":"09b4et8c4eb24s8abta8b8a"}

Hash calculado:
4e36de37b87010d301e4b3a9046befe24ef253a98746f1d43998f29c31e188d4

Este hash calculado se debe comparar con el hash recibido en el header de la notificacion.
                

Consultar Pago

Consultar el estado de un pago específico.

Endpoint

Request

Response (HTTP 200)

{
    id: "",
    status: "",
    amount: 0.00,
    date: "",
    reference: ""
}

Errores Comunes

Estados de la Transacción

Consultar Pago por Id Externo

Consultar el estado de un pago específico a partir del identificador externo.

Endpoint

Request

Response (HTTP 200)

{
    id: "",
    status: "",
    amount: 0.00,
    date: "",
    reference: ""
}

Errores Comunes