PayCode Connect · C#/.NET

dotnet add package PaycodeConnect

<PackageReference Include="PaycodeConnect" Version="1.2.4" />

using PaycodeConnectSDK;

PaycodeConnect node = new PaycodeConnect();
node.Setup();

// Con un callback de finalización
node.Setup((resultCode) =>
{
    // ResultCode.Success si todo salió bien
});

string ticket = node.GenerateTicket();
string qrBase64 = node.GenerateQRCodeBase64(ticket);

// Ejemplo con WinUI / UWP
qrImage.Source = Base64ToImage(qrBase64);

BitmapImage Base64ToImage(string base64)
{
    byte[] bytes = Convert.FromBase64String(base64);
    using MemoryStream ms = new MemoryStream(bytes);
    BitmapImage img = new BitmapImage();
    img.SetSource(ms.AsRandomAccessStream());
    return img;
}

node.ReconnectToLastNode((resultCode) =>
{
    // ResultCode.Success si la reconexión fue exitosa
});

node.ConnectionChange += (sender, e) =>
{
    bool isConnected = e.Connected;
};

node.EMVStateChange += (sender, e) =>
{
    EMVData data = e.Data;

    // Acceder a la metadata que se envió en StartEMV
    var meta = data.GetMetadata<OrderMetadata>();
    if (meta != null)
    {
        string orderId = meta.OrderId;
        int table = meta.Table;
    }

    switch (data.State)
    {
        case EMVState.AwaitingCard:
            statusText.Text = "Present card on terminal...";
            break;
        case EMVState.Processing:
            statusText.Text = "Processing...";
            break;
        case EMVState.Success:
            statusText.Text = $"Approved! Auth: {data.Transaction?.Authorization}";
            break;
        case EMVState.Error:
            statusText.Text = $"Error {data.Code}: {data.Message}";
            break;
        case EMVState.Reversal:
            statusText.Text = data.Code == 0 ? "Reversal successful" : "Reversal failed";
            break;
    }
};

node.PresenceChange += (sender, e) =>
{
    bool hasPresence = e.Presence;
};

node.TerminalScanner += (sender, e) =>
{
    string barcode = e.Content;
};

node.LostMessagesEvent += (sender, e) =>
{
    if (e.Messages != null)
    {
        foreach (EMVData msg in e.Messages)
        {
            // Procesar cada mensaje perdido
        }
    }

    if (e.HasLostMessages.HasValue)
    {
        bool hasLost = e.HasLostMessages.Value;
    }
};

node.StartEMV("150.00");

// Especificando el tipo de EMV
node.StartEMV("150.00", EMVType.Amex);

// Con callback (sin necesidad de pasar null en metadata)
node.StartEMV("150.00", EMVType.Combined, (code) =>
{
    // ResultCode.Success si todo salió bien
});

// Con metadata
node.StartEMV("150.00", EMVType.Combined, new { orderId = "abc-123", table = 5 });

// Con metadata y callback
node.StartEMV("150.00", EMVType.Combined, new { orderId = "abc-123", table = 5 }, (code) =>
{
    // ResultCode.Success si todo salió bien
});

node.ReverseTransaction("123456789");

node.PrintTransaction("123456789");

node.SetCapabilities(new Capabilities
{
    ScannerPrefixes = new[] { "PREFIX1", "PREFIX2" },
    ForceRemoteControl = true,
});

node.Authorize("user@example.com", "password");

node.SetPin(new PinPayload { Pin = "1234", Password = "password" });

node.AuthorizePin("1234");

node.Logout();

// Verificar si existen mensajes perdidos
node.RequestHasLostMessages();

// Recuperar todos los mensajes perdidos
node.RequestLostMessages();

// Limpiar todos los mensajes perdidos
node.ClearLostMessages();

// Apagar de forma permanente
node.Shutdown();

// Apagar y reiniciar
node.Shutdown(true);

public struct EMVData
{
    public EMVState State { get; set; }
    public int? Code { get; set; }
    public string? Message { get; set; }
    public Transaction? Transaction { get; set; }
    public string? id { get; set; }
    public bool? lost { get; set; }
    public object? Metadata { get; set; }

    public T? GetMetadata<T>()
    {
        if (Metadata is JsonElement element)
            return element.Deserialize<T>();
        return default;
    }
}

// Definir una clase que coincida con la metadata enviada en StartEMV
public class OrderMetadata
{
    public string OrderId { get; set; }
    public int Table { get; set; }
}

// Deserializar dentro del manejador del evento
var meta = emvData.GetMetadata<OrderMetadata>();

public struct Transaction
{
    public string Authorization { get; set; }
    public string Reference { get; set; }
    public string Folio { get; set; }
    public string? Type { get; set; }
    public string? CardBrand { get; set; }
    public string? CardNumber { get; set; }
    public string? Issuer { get; set; }
    public string? Total { get; set; }
    public string? Subtotal { get; set; }
    public string? Tip { get; set; }
    public string? Arqc { get; set; }
    public string? Aid { get; set; }
    public string? Al { get; set; }
    public string? Tvr { get; set; }
    public string? Tsi { get; set; }
}

public struct Capabilities
{
    public string[]? ScannerPrefixes { get; set; }
    public bool? PingInternetConnectivity { get; set; }
    public bool? ForceRemoteControl { get; set; }
    public bool? DisableManualPayments { get; set; }
    public string? LostMessagesSyncMode { get; set; }
}

public struct PinPayload
{
    public string Pin { get; set; }
    public string Password { get; set; }
}

public enum EMVState
{
    NotStarted,
    AwaitingCard,
    Processing,
    Success,
    Error,
    Reversal
}

public enum EMVType
{
    Emv,      // Visa / Mastercard
    Amex,     // American Express
    Combined  // Detección automática (valor por defecto)
}

public enum ResultCode
{
    Success = 0,
    StateUnavailable = 1,
    NodeUnavailable = 2,
    RuntimeUnavailable = 3,
    SenderNotAvailable = 4,
    ConnectionTimeout = 5,
    EndpointOnlineTimeout = 6,
    Utf8Conversion = 7,
    IrohEndpointBind = 8,
    IrohJoin = 9,
    GossipApi = 10,
    GossipNet = 11,
    IrohKeyParse = 12,
    Decode = 13,
    Json = 14,
    Anyhow = 15,
    TryLock = 16,
    Nul = 17,
    SetLogger = 18,
    Panic = 999
}

public enum LostMessagesSyncMode
{
    Auto,
    Manual
}