Transacciones

Aquí podrás consultar el estado y las transacciones que se hayan realizado a tu negocio.

Consultar transacción

Podrás consultar todos los detalles de alguna transacción en particular.

Verificar las transacciones

POST https://sandbox.apagar.co/api/v1/transactions/query

Request Body

Name	Type	Description
data*	Object	Datos principales
filters*	Object	Objeto que contendrá todos los filtros posibles
timeStart*	string	Hora inicial del rango donde podría estar la transacción
timeEnd*	string	Hora final del rango donde podría estar la transacción.
amount	int	valor de la transacción a consultar.
origin	string	cuenta de origen de pago
date	string	fecha de la transacción a consultar.

200 Exitosa

Request

{
  "data": {
    "Transaction": {
      "id": **95,
      "User": {
        "id": 23
      },
      "PaymentMethod": {
        "id": **95,
        "name": "Daviplata",
        "type": "QR"
      },
      "billNum": null,
      "Resource": {
        "id": null
      },
      "Status": {
        "id": 2,
        "name": "Transacción aprobada"
      },
      "Type": {
        "id": 1
      },
      "cost": 0,
      "tax": null,
      "amount": 30000,
      "preBalance": 141309704.0492,
      "posBalance": 141339704.0492,
      "bankReference": "****MDMvMjAyMTEyOjE2OjEyMzAwMDAzMTI0MTA3NDMz",
      "originAccount": "***4107433",
      "Product": {
        "name": null
      },
      "meta": null,
      "description": "Nota Crédito -  Nc Transf Fondos Desde Daviplata",
      "confirmedAt": "2021-03-04 15:54:00",
      "confirmedCompany": null,
      "createdAt": "2021-03-04 15:53:00",
      "updatedAt": "2021-03-04 15:54:00"
    }
  },
  "signature": "****f3c879a59c7ca43dafcdd4c5a308177aeacc",
  "date": ****850138431,
  "status": 200,
  "message": "Successful"
}

404: Not Found Transaccion no encontrada

Response

{
    "signature": "b9cbb7baf92450efe048bab223af6598d9dc8b13",
    "path": "/query",
    "date": 165***7216019,
    "status": 404,
    "errorCode": "transaction.notFound",
    "message": "Transacción no encontrada"
}

401: Unauthorized Sesión terminada

Response

{
    "signature": null,
    "path": "/query",
    "date": 1655858802020,
    "status": 401,
    "errorCode": "auth.sessionEnded",
    "message": "Sesión terminada"
}

Estado transacción

Para realizar nuestra petición del estado de la transacción es requerido dos datos obtenidos como respuesta en le generación del recurso de pago :

• Utilizar el reference y el id del PaymentMethod

Si no se escribe de manera correcta ambos datos podríamos obtener un error en la petición

Servicio para obtener el estado de una transaccion

POST https://sandbox.apagar.co/api/v1/transactions/status

Request Body

Name	Type	Description
data*	Object	Datos principales
resource*	Object	recurso de datos
reference*	int	Hora inicial del rango donde podría referencia del pago o transacción
paymentMethod*	Object	Data de método de pago
id*	int	identificador del método de pago

200 Estado

Request

{
  "data": {
    "data": {
      "id": **04,
      "company": "Superpagos S.A.S.",
      "bankTransactionID": "_eHD2OpIr7b",
      "amount": 1000,
      "iva": 0,
      "soliciteDate": "2021/05/26 22:41:45",
      "bankDate": "2021/05/26 22:38:21",
      "state": "approved",
      "description": "Multiproducto",
      "bank": "Bancolombia"
    }
  },
  "signature": "****c1a41f74263ed6b68154ae371daef7f7bb00",
  "date": ****086905204,
  "status": 200,
  "message": "Successful"
}

400: Bad Request Referencia no encontrada.

Response

{
    "signature": null,
    "path": "/status",
    "date": 16****59558253,
    "status": 400,
    "errorCode": "transaction.reference.notFound",
    "message": "Referencia no encontrada"
}