Skip to main content
Los objetos de error mostrados en los diagramas son ilustrativos. Pueden variar dependiendo de la causa del error. El banco debe enviar el objeto error con la información correspondiente a la causa real del fallo.

​
Endpoint /status

Este endpoint funciona como canal de notificación. TransfiYa lo utiliza para enviar una acción (action) como confirmación de aceptación o rechazo de la transferencia por parte del destinatario. El banco puede implementar lógica personalizada para procesar estas notificaciones según su arquitectura o necesidades operativas.
  • Status Request
  • Response
  • Error Response 400
{
  "source": "wLd9MEASjQQTYywoXnDNwTRpgwiDfyHj6U",
  "target": "$573123224353",
  "amount": "200.00",
  "symbol": "$tin",
  "labels": {
    "hash": "51e8c19c57e846d7dc5665203665f5202df549bed703fe63ad7511c44606843d",
    "type": "SEND",
    "domain": "tin",
    "flowId": "BeK495NIBA4j7x48z",
    "status": "COMPLETED",
    "tx_ref": "BeK495NIBA4j7x48z",
    "created": "2022-08-04T11:57:50-05:00",
    "iouHash": "cca34be82af60bf6aa262cf86249d97e07367bc1b367f5416659b4a0f9e321e4",
    "updated": "2022-08-04T11:58:10-05:00",
    "description": "DEV - REQUEST trx 01",
    "sourceChannel": "APP",
    "deviceFingerPrint": {
      "city": "Bogotá",
      "hash": "26fff5af6441f8e15a71e8d62c361714484b1b308c99e8eb68ca85e2a7e0dc58",
      "model": "Huawei Mate 20 Pro",
      "country": "Colombia",
      "operator": "Bharti Airtel Limited",
      "SIMCardId": "8991101200003204510",
      "ipAddress": "2001:0db8:85a3:0000:0000:8a2e:0370:7334",
      "mobileDevice": "990000862471854"
    }
  },
  "snapshot": {
    "source": {
      "signer": {
        "handle": "wLd9MEASjQQTYywoXnDNwTRpgwiDfyHj6U",
        "labels": {
          "firstName": "Cale",
          "lastName": "Sanford",
          "identification": "1231231",
          "bankBicfi": "9574",
          "bankName": "bancosanti",
          "proprietary": "CC"
        }
      },
      "wallet": {
        "handle": "$573123224352",
        "labels": {
          "type": "PERSON",
          "created": "2022-06-10T09:54:42-05:00",
          "updated": "2022-06-10T09:54:42-05:00"
        },
        "signer": ["wLd9MEASjQQTYywoXnDNwTRpgwiDfyHj6U"]
      }
    },
    "symbol": {
      "signer": {
        "handle": "wMxKCAzsQBiUURDU3xD3xuSbVo1S9jmf3d",
        "labels": {
          "created": "2018-10-19T20:23:22.041Z",
          "createdBy": "ZhrQA3vcm17h2RRO4LrJ"
        }
      },
      "wallet": {
        "handle": "$tin",
        "labels": {
          "type": "SYMBOL",
          "created": "2018-10-19T20:22:48.350Z",
          "updated": "1970-01-01T15:38:20-05:00",
          "createdBy": "ZhrQA3vcm17h2RRO4LrJ"
        },
        "signer": ["wMxKCAzsQBiUURDU3xD3xuSbVo1S9jmf3d"],
        "default": "wMxKCAzsQBiUURDU3xD3xuSbVo1S9jmf3d"
      }
    },
    "target": {
      "signer": {
        "handle": "wVVPzAGAkv5a2AANEdmeActMpWhbByQ81v",
        "labels": {
          "firstName": "Otha",
          "lastName": "Lehner",
          "identification": "123456",
          "bankBicfi": "9574",
          "bankName": "bancosanti",
          "proprietary": "CC"
        }
      },
      "wallet": {
        "handle": "$573123224353",
        "labels": {
          "type": "PERSON",
          "created": "2022-06-10T09:57:21-05:00",
          "updated": "2022-06-10T11:19:10-05:00"
        },
        "signer": [
          "wVVPzAGAkv5a2AANEdmeActMpWhbByQ81v",
          "wVXQDT59RzXdPZD4CyK6z8FWebZmyZ9aHm"
        ]
      }
    }
  },
  "action_id": "98f2f910-fcf2-4937-9ba3-6fb5f9080a17",
  "error": {
    "code": 0,
    "message": "Success"
  },
  "id": "98f2f910-fcf2-4937-9ba3-6fb5f9080a17"
}
Nota:La información privada contenida en signer.labels y wallet.labels se incluye en la acción enviada al endpoint /status solo si el source y el target pertenecen al mismo banco. En caso contrario, el banco receptor únicamente recibe información pública.Además, la información del usuario target solo se incluye si la transferencia fue aceptada.A continuación se detallan los campos considerados públicos y privados:Campos públicos del signer (todo lo no listado se considera privado):
  • firstName
  • lastName
  • identification
  • bankBicfi
  • bankName
  • proprietary
Campos privados del wallet (todo lo no listado se considera público):
  • channelSms