LaConnet Gateway Integration Guide

using System.Net.Http.Json;
using System.Text.Json;

var client = new HttpClient
{
    BaseAddress = new Uri("https://sandbox.laconnet.com")
};

client.DefaultRequestHeaders.Add(
    "X-Api-Key",
    "YOUR_API_KEY");

client.DefaultRequestHeaders.Add(
    "X-Api-Secret",
    "YOUR_API_SECRET");

client.DefaultRequestHeaders.Add(
    "X-Store-Identifier",
    "YOUR_STORE_IDENTIFIER");

client.DefaultRequestHeaders.Add(
    "Idempotency-Key",
    "1199679095");

var request = new
{
    orderId = "1646794917",
    amount = 100.50m,
    currency = "USD",

    customer = new
    {
        firstName = "John",
        lastName = "Doe",
        email = "john.doe@example.com",

        address = new
        {
            street = "123 Main Street",
            city = "New York",
            state = "NY",
            country = "USA",
            phoneNumber = "+1 905123456",
            zipPostalCode = "903856",
            mobilePhone = "+1 905123456"
        }
    },

    card = new
    {
        nameOnCard = "John Doe",
        cardNumber = "5123450000000008",
        expiryMonth = "01",
        expiryYear = "2039",
        cvv = "100"
    },

    useGatewayAuthentication = true,
    captureOnAuthorization = true,

    returnUrl =
        "https://webhook.site/92aa241a-4a08-4ba9-b47c-a2384b07221a",

    idempotencyKey = "1199679095"
};

var response = await client.PostAsJsonAsync(
    "/api/gateway/v2/transaction/pay",
    request);

var responseBody =
    await response.Content.ReadAsStringAsync();

if (!response.IsSuccessStatusCode)
{
    throw new InvalidOperationException(
        $"Payment request failed: {responseBody}");
}

using var document =
    JsonDocument.Parse(responseBody);

var root = document.RootElement;

/*
|--------------------------------------------------------------------------
| Check whether LaConnet Gateway requires 3DS authentication
|--------------------------------------------------------------------------
*/

var serverAuthentication =
    root.TryGetProperty(
        "serverAuthentication",
        out var serverAuthenticationProperty)
    &&
    serverAuthenticationProperty.ValueKind ==
        JsonValueKind.True;

var redirectUrl =
    root.TryGetProperty(
        "redirectUrl",
        out var redirectUrlProperty)
        ? redirectUrlProperty.GetString()
        : null;

var authenticationTransactionId =
    root.TryGetProperty(
        "authenticationTransactionId",
        out var authenticationIdProperty)
        ? authenticationIdProperty.GetString()
        : null;

if (
    serverAuthentication &&
    !string.IsNullOrWhiteSpace(redirectUrl)
)
{
    /*
     * Return redirectUrl to your frontend.
     *
     * Your frontend must redirect the CUSTOMER'S BROWSER
     * to this URL.
     */

    return new
    {
        requiresAuthentication = true,
        redirectUrl,
        authenticationTransactionId
    };
}

/*
|--------------------------------------------------------------------------
| No authentication redirect required
|--------------------------------------------------------------------------
*/

var status =
    root.TryGetProperty(
        "status",
        out var statusProperty)
        ? statusProperty.GetString()
        : null;

var transactionReference =
    root.TryGetProperty(
        "gatewayTransactionReference",
        out var referenceProperty)
        ? referenceProperty.GetString()
        : null;

return new
{
    requiresAuthentication = false,
    status,
    transactionReference
};

const response = await fetch(
  "https://sandbox.laconnet.com/api/gateway/v2/transaction/pay",
  {
    method: "POST",

    headers: {
      "Content-Type": "application/json",
      "X-Api-Key": "YOUR_API_KEY",
      "X-Api-Secret": "YOUR_API_SECRET",
      "X-Store-Identifier": "YOUR_STORE_IDENTIFIER",
      "Idempotency-Key": "1199679095"
    },

    body: JSON.stringify({
      orderId: "1646794917",
      amount: 100.50,
      currency: "USD",

      customer: {
        firstName: "John",
        lastName: "Doe",
        email: "john.doe@example.com",

        address: {
          street: "123 Main Street",
          city: "New York",
          state: "NY",
          country: "USA",
          phoneNumber: "+1 905123456",
          zipPostalCode: "903856",
          mobilePhone: "+1 905123456"
        }
      },

      card: {
        nameOnCard: "John Doe",
        cardNumber: "5123450000000008",
        expiryMonth: "01",
        expiryYear: "2039",
        cvv: "100"
      },

      useGatewayAuthentication: true,

      captureOnAuthorization: true,

      returnUrl:
        "https://webhook.site/92aa241a-4a08-4ba9-b47c-a2384b07221a",

      idempotencyKey: "1199679095"
    })
  }
);

const result = await response.json();

if (!response.ok) {
  throw new Error(
    result?.error?.explanation ||
    result?.message ||
    "Payment request failed."
  );
}

/*
|--------------------------------------------------------------------------
| Gateway-managed 3DS Authentication
|--------------------------------------------------------------------------
|
| If serverAuthentication is true, redirect the customer's browser
| to the redirectUrl returned by LaConnet Gateway.
|
*/

if (
  result.serverAuthentication === true &&
  result.redirectUrl
) {
  window.location.href = result.redirectUrl;
  return;
}

/*
|--------------------------------------------------------------------------
| No redirect required
|--------------------------------------------------------------------------
*/

if (
  result.status === "CAPTURED" ||
  result.status === "APPROVED"
) {
  console.log(
    "Payment completed:",
    result.gatewayTransactionReference
  );

  return;
}

console.log(
  "Payment status:",
  result.status
);

/*
 * This response should normally be passed from
 * your backend to your frontend.
 */

if (
    response.ServerAuthentication &&
    !string.IsNullOrWhiteSpace(response.RedirectUrl)
)
{
    return Redirect(response.RedirectUrl);
}

/*
 * result is the response returned from Create Payment.
 */

if (
  result.serverAuthentication === true &&
  result.redirectUrl
) {
  // Redirect the CUSTOMER'S BROWSER to LaConnet Gateway.
  window.location.href = result.redirectUrl;
}