GatekeeperX.Events.Sdk 1.0.2

GatekeeperX.Events.Sdk

SDK oficial de .NET para integración con GatekeeperX Events API - Plataforma de detección de fraude y evaluación de riesgo en tiempo real.

Instalación

dotnet add package GatekeeperX.Events.Sdk

O en el Package Manager:

Install-Package GatekeeperX.Events.Sdk

Inicio Rápido

using GatekeeperX.Events.Sdk;
using GatekeeperX.Events.Sdk.Models.Request;

// Crear cliente
using var client = EventsApiClient.Builder()
    .Sandbox()  // o .Production()
    .WithOrganizationId("tu-organization-id")
    .WithApiKey("tu-api-key")
    .Build();

// Crear request
var request = EventRequest.Builder()
    .WithEventType("create_cashout")
    .WithTimestamp(DateTimeOffset.UtcNow.ToUnixTimeMilliseconds())
    .WithCustomer(Customer.Builder()
        .WithCustomerId("cust_001")
        .WithEmail("usuario@ejemplo.com")
        .Build())
    .WithMovement(Movement.Builder()
        .WithMovementId("mov_001")
        .WithAmount(Money.Builder()
            .WithAmount(50000m)
            .WithAmountInMinorUnits(5000000)
            .WithCurrencyCode("COP")
            .Build())
        .Build())
    .Build();

// Enviar evento
var response = await client.ProcessEventAsync(request);

Console.WriteLine($"Decision: {response.Decision}");  // allow, block, review
Console.WriteLine($"Score: {response.Evaluation?.Score}");

Configuración del Cliente

Configuración Básica

using var client = EventsApiClient.Builder()
    .Sandbox()
    .WithOrganizationId("tu-organization-id")
    .WithApiKey("tu-api-key")
    .Build();

Configuración Avanzada

using var client = EventsApiClient.Builder()
    .Production()
    .WithOrganizationId("tu-organization-id")
    .WithApiKey("tu-api-key")
    .WithTimeout(TimeSpan.FromSeconds(30))
    .WithMaxRetries(3)
    .WithRetryBackoff(TimeSpan.FromMilliseconds(500))
    .WithRetryMultiplier(2.0)
    .WithMaxBackoff(TimeSpan.FromSeconds(10))
    .WithLogger(logger)  // ILogger opcional
    .Build();

Métodos Disponibles

ProcessEventAsync (Recomendado)

var response = await client.ProcessEventAsync(
    request, 
    returnScore: true,  // true para obtener score, false para async
    cancellationToken: default
);

ProcessEvent (Síncrono)

var response = client.ProcessEvent(request, returnScore: true);

Tipos de Eventos

create_cashout (Retiros / Transferencias P2P)

var request = EventRequest.Builder()
    .WithEventType("create_cashout")
    .WithTimestamp(DateTimeOffset.UtcNow.ToUnixTimeMilliseconds())
    .WithMovement(Movement.Builder()
        .WithMovementId("7e43e0ce-69ab-406d-baa4-8ce0c31df36d")
        .WithExternalId("1955346017")
        .WithType("4")
        .WithStatus("")
        .WithCreatedAt("2026-11-20T10:00:00Z")
        .WithUpdatedAt("2026-11-20T10:10:00Z")
        .WithAmount(Money.Builder()
            .WithCurrencyCode("COP")
            .WithAmount(25000.2m)
            .WithAmountInMinorUnits(2500000)
            .Build())
        .WithOrigin(MovementOrigin.Builder()
            .WithPaymentMethod(MovementPaymentMethod.Builder()
                .WithType("bankAccount")
                .WithPaymentMethodId("ef454b2f-4681-41f4-9b2f-5c3aced5d4a8")
                .WithAccountNumber("100000056298")
                .WithBankCode("BOFAUS3N")
                .WithCustomFields(new Dictionary<string, object>
                {
                    { "thirdPartyId", 11 },
                    { "subKey", "xx" }
                })
                .Build())
            .WithCustomFields(new Dictionary<string, object>
            {
                { "accountBalanceHistoricId", "uuid" },
                { "finalValue", 4000 }
            })
            .Build())
        .WithDestination(MovementDestination.Builder()
            .WithPaymentMethod(MovementPaymentMethod.Builder()
                .WithType("bankAccount")
                .WithPaymentMethodId("pm-2")
                .WithAccountNumber("1234567890")
                .WithBankCode("BOFAUS3N")
                .WithBankId("BOFAUS3N")
                .WithBankName("Bank of America")
                .Build())
            .Build())
        .Build())
    .WithCustomer(Customer.Builder()
        .WithCustomerId("prueba_movi3")
        .WithPhoneNumber("+15555551234")
        .WithEmail("john.doe@example.com")
        .WithEmailVerifiedAt(true)
        .WithFirstName("John")
        .WithLastName("Doe")
        .WithBirthDate("2025-05-18")
        .WithGender("1")
        .WithIsPep(true)
        .WithTags(new List<string> { "1" })
        .WithThirdPartyId("0")
        .WithCreatedAt("2025-04-01T09:00:00Z")
        .WithAddress(Location.Builder()
            .WithCountry("US")
            .WithStreet1("1 Market St")
            .WithCity("San Francisco")
            .WithRegion("CA")
            .Build())
        .WithIdentificationDocument(IdentificationDocument.Builder()
            .WithType("1")
            .WithNumber("12345456")
            .WithExpeditionDate("2025-05-18")
            .WithExpirationDate("2030-05-18")
            .Build())
        .WithExternalRisk(new List<ExternalRisk>
        {
            ExternalRisk.Builder().WithSegment(1).WithScore(1).WithScoreProvider(1).Build(),
            ExternalRisk.Builder().WithSegment(2).WithScore(2).WithScoreProvider(2).Build()
        })
        .Build())
    .WithPaymentMethod(PaymentMethod.Builder()
        .WithType("bankAccount")
        .WithPaymentMethodId("ef454b2f-4681-41f4-9b2f-5c3aced5d4a8")
        .WithAccountNumber("100000056298")
        .WithBankCode("1")
        .Build())
    .Build();

var response = await client.ProcessEventAsync(request);

create_transaction (Compras / Ventas)

var request = EventRequest.Builder()
    .WithEventType("create_transaction")
    .WithTimestamp(DateTimeOffset.UtcNow.ToUnixTimeMilliseconds())
    .WithTransaction(Transaction.Builder()
        .WithTransactionId("txn_001")
        .WithAmount(Money.Builder()
            .WithAmount(95.76m)
            .WithAmountInMinorUnits(9576)
            .WithCurrencyCode("USD")
            .Build())
        .WithStatus("completed")
        .WithType("sale")
        .WithIp("192.168.1.1")
        .WithPointOfSale(PointOfSale.Builder()
            .WithTerminalId("TID12345")
            .WithBrand("PAX")
            .WithModel("A80")
            .Build())
        .Build())
    .WithCustomer(Customer.Builder()
        .WithCustomerId("cust_001")
        .WithEmail("cliente@ejemplo