​
Tipo 1 y Tipo 2: Transferencias P2P (SEND)

Para iniciar una nueva transferencia P2P del tipo Tipo 1 o Tipo 2, se debe realizar una solicitud POST al endpoint: POST /v1/transfer Este método orquesta la ejecución completa del flujo de transferencia P2P en TIN Cloud.
  • Tipo 1: Transferencia con aceptación (sin relación de confianza).
  • Tipo 2: Transferencia inmediata (con relación de confianza).
La ejecución de este endpoint permite iniciar la acción SEND, que a su vez gestionará las acciones necesarias como UPLOAD (débito), SEND (transferencia) y DOWNLOAD (crédito), dependiendo del tipo de flujo que se aplique. Descripción del diagrama
Antes de iniciar una transferencia, debes agregar los detalles del dispositivo (Device Fingerprint) en el objeto labels.deviceFingerPrint.

​
Ejemplo de solicitud cURL

      curl -X POST -H "API_KEY: 5b481fc2ae177010e197026ba5b51227c44243cd9a18e41be536566e" -H "Authorization: Bearer asdfwXTdDQFimVQOMdn9bOGHJh8KrqnFi34sugYqgrULRCb" -H "Content-Type: application/json" -d '{
          "source": "wsource_user_bridge_address",
          "target": "$target_user_phone_number",
          "symbol": "$tin",
          "amount": "AMOUNT",
          "labels": {
              "type": "SEND",
              "description": "Description of a transfer",
              "sourceCreated": "ISO_TIMESTAMP",
              "transactionPurpose": "TRANSFER",
          "numberOfTransactions": "1",
              "sourceChannel": "APP",
          "deviceFingerprint": {
                  "hash": "26fff5af6441f8e15a71e8d62c361714484b1b308c99e8eb68ca85e2a7e0dc58",
              "ipAddress": "190.242.46.190",
              "geolocation": " ",
              "country": "Colombia",
              "city": "Bogota",
              "mobileDevice": "a",
              "SIMCardId": "a",
              "model": "a",
              "operator": "D"
              }
          }
      }' "https://ach-minka-tst.transferenciasinmediatas.com/v1/transfer"

CreateTransferRequest createTransferRequest = new CreateTransferRequest();
createTransferRequest.Source = "wsource_user_bridge_address";
createTransferRequest.Target = "$target_user_phone_number";
Dictionary<String, object> labels = new Dictionary<String, Object>();
createTransferRequest.Labels = labels;
labels["type"] = "SEND";
labels["description"] = "Description of a transfer";
createTransferRequest.Amount = "AMOUNT";
createTransferRequest.Symbol = "$tin";


instance.Configuration.AddApiKey("x-api-key","5b481fc2ae177010e197026b39c58cdb000f4c3897e841714e82c84c");

var response = instance.CreateTinTransfer(createTransferRequest);

​
Crear Relación de Confianza

Para realizar una transferencia de tipo TYPE2, se requiere crear un vínculo de confianza (trust link) antes de ejecutar la solicitud de transferencia. Cuando existe una relación de confianza, cualquier transacción generada desde un signer dentro del wallet origen será transferida inmediatamente al signer de destino definido en el vínculo de confianza, sin necesidad de aceptación manual por parte del usuario receptor.
Las relaciones de confianza permiten ejecutar flujos de transferencia inmediatos sin enviar notificaciones ni requerir aceptación por parte del receptor.
curl -X PUT -H "x-api-key: 5b481fc2ae177010e197026ba5b51227c44243cd9a18e41be536566e" -H "Authorization: Bearer asdfwXTdDQFimVQOMdn9bOGHJh8KrqnFi34sugYqgrULRCb" -H "Content-Type: application/json" -d '{
"source": "$USER1_PHONE_NUMBER",
"target": "USER2_SIGNER",
"type": "TRUST"
}' "https://ach-minka-stg.transferenciasinmediatas.com/v1/link/"

​
Buscar transferencia en el Dashboard

Para consultar una transferencia, ve a la sección Transferencias en el Dashboard, donde encontrarás el listado completo de todas las transferencias realizadas. Descripción del diagrama Haz clic en “detalles” para ver la información detallada de una transferencia específica. Descripción del diagrama