@gr4vy/sdk 1.0.0-beta.8 → 1.0.0

package/docs/sdks/transactions/README.md

@@ -10,12 +10,11 @@
 * [get](#get) - Get transaction
 * [capture](#capture) - Capture transaction
 * [void](#void) - Void transaction
-* [summary](#summary) - Get transaction summary
 * [sync](#sync) - Sync transaction
 
 ## list
 
-List all transactions for a specific merchant account sorted by most recently created.
+Returns a paginated list of transactions for the merchant account, sorted by most recently updated. You can filter, sort, and search transactions using query parameters.
 
 ### Example Usage
 
@@ -23,6 +22,7 @@ List all transactions for a specific merchant account sorted by most recently cr
 import { Gr4vy } from "@gr4vy/sdk";
 
 const gr4vy = new Gr4vy({
+  merchantAccountId: "<id>",
   server: "sandbox",
   id: "example",
   bearerAuth: withToken({
@@ -31,61 +31,9 @@ const gr4vy = new Gr4vy({
 });
 
 async function run() {
-  const result = await gr4vy.transactions.list({
-    cursor: "ZXhhbXBsZTE",
-    createdAtLte: new Date("2022-01-01T12:00:00+08:00"),
-    createdAtGte: new Date("2022-01-01T12:00:00+08:00"),
-    updatedAtLte: new Date("2022-01-01T12:00:00+08:00"),
-    updatedAtGte: new Date("2022-01-01T12:00:00+08:00"),
-    search: "transaction-12345",
-    buyerExternalIdentifier: "buyer-12345",
-    buyerId: "fe26475d-ec3e-4884-9553-f7356683f7f9",
-    buyerEmailAddress: "john@example.com",
-    status: [
-      "authorization_succeeded",
-    ],
-    id: "7099948d-7286-47e4-aad8-b68f7eb44591",
-    paymentServiceTransactionId: "tx-12345",
-    externalIdentifier: "transaction-12345",
-    metadata: [
-      "{\"first_key\":\"first_value\",\"second_key\":\"second_value\"}",
-    ],
-    amountEq: 1299,
-    amountLte: 1299,
-    amountGte: 1299,
-    currency: [
-      "USD",
-    ],
-    paymentServiceId: [
-      "fffd152a-9532-4087-9a4f-de58754210f0",
-    ],
-    paymentMethodId: "ef9496d8-53a5-4aad-8ca2-00eb68334389",
-    paymentMethodLabel: "1234",
-    paymentMethodFingerprint: "a50b85c200ee0795d6fd33a5c66f37a4564f554355c5b46a756aac485dd168a4",
-    method: [
-      "card",
-    ],
-    errorCode: [
-      "insufficient_funds",
-    ],
-    hasRefunds: true,
-    pendingReview: true,
-    checkoutSessionId: "4137b1cf-39ac-42a8-bad6-1c680d5dab6b",
-    reconciliationId: "7jZXl4gBUNl0CnaLEnfXbt",
-    hasGiftCardRedemptions: true,
-    giftCardId: "356d56e5-fe16-42ae-97ee-8d55d846ae2e",
-    giftCardLast4: "7890",
-    hasSettlements: true,
-    paymentMethodBin: "411111",
-    paymentSource: [
-      "recurring",
-    ],
-    isSubsequentPayment: true,
-    merchantInitiated: true,
-  });
+  const result = await gr4vy.transactions.list();
 
   for await (const page of result) {
-    // Handle the page
     console.log(page);
   }
 }
@@ -105,6 +53,7 @@ import { transactionsList } from "@gr4vy/sdk/funcs/transactionsList.js";
 // Use `Gr4vyCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
 const gr4vy = new Gr4vyCore({
+  merchantAccountId: "<id>",
   server: "sandbox",
   id: "example",
   bearerAuth: withToken({
@@ -113,69 +62,15 @@ const gr4vy = new Gr4vyCore({
 });
 
 async function run() {
-  const res = await transactionsList(gr4vy, {
-    cursor: "ZXhhbXBsZTE",
-    createdAtLte: new Date("2022-01-01T12:00:00+08:00"),
-    createdAtGte: new Date("2022-01-01T12:00:00+08:00"),
-    updatedAtLte: new Date("2022-01-01T12:00:00+08:00"),
-    updatedAtGte: new Date("2022-01-01T12:00:00+08:00"),
-    search: "transaction-12345",
-    buyerExternalIdentifier: "buyer-12345",
-    buyerId: "fe26475d-ec3e-4884-9553-f7356683f7f9",
-    buyerEmailAddress: "john@example.com",
-    status: [
-      "authorization_succeeded",
-    ],
-    id: "7099948d-7286-47e4-aad8-b68f7eb44591",
-    paymentServiceTransactionId: "tx-12345",
-    externalIdentifier: "transaction-12345",
-    metadata: [
-      "{\"first_key\":\"first_value\",\"second_key\":\"second_value\"}",
-    ],
-    amountEq: 1299,
-    amountLte: 1299,
-    amountGte: 1299,
-    currency: [
-      "USD",
-    ],
-    paymentServiceId: [
-      "fffd152a-9532-4087-9a4f-de58754210f0",
-    ],
-    paymentMethodId: "ef9496d8-53a5-4aad-8ca2-00eb68334389",
-    paymentMethodLabel: "1234",
-    paymentMethodFingerprint: "a50b85c200ee0795d6fd33a5c66f37a4564f554355c5b46a756aac485dd168a4",
-    method: [
-      "card",
-    ],
-    errorCode: [
-      "insufficient_funds",
-    ],
-    hasRefunds: true,
-    pendingReview: true,
-    checkoutSessionId: "4137b1cf-39ac-42a8-bad6-1c680d5dab6b",
-    reconciliationId: "7jZXl4gBUNl0CnaLEnfXbt",
-    hasGiftCardRedemptions: true,
-    giftCardId: "356d56e5-fe16-42ae-97ee-8d55d846ae2e",
-    giftCardLast4: "7890",
-    hasSettlements: true,
-    paymentMethodBin: "411111",
-    paymentSource: [
-      "recurring",
-    ],
-    isSubsequentPayment: true,
-    merchantInitiated: true,
-  });
-
-  if (!res.ok) {
-    throw res.error;
-  }
-
-  const { value: result } = res;
-
-  for await (const page of result) {
-    // Handle the page
+  const res = await transactionsList(gr4vy);
+  if (res.ok) {
+    const { value: result } = res;
+    for await (const page of result) {
     console.log(page);
   }
+  } else {
+    console.log("transactionsList failed:", res.error);
+  }
 }
 
 run();
@@ -214,15 +109,15 @@ run();
 
 ## create
 
-Create a transaction.
+Create a new transaction using a supported payment method. If additional buyer authorization is required, an approval URL will be returned. Duplicated gift card numbers are not supported.
 
 ### Example Usage
 
 ```typescript
 import { Gr4vy } from "@gr4vy/sdk";
-import { RFCDate } from "@gr4vy/sdk/types";
 
 const gr4vy = new Gr4vy({
+  merchantAccountId: "<id>",
   server: "sandbox",
   id: "example",
   bearerAuth: withToken({
@@ -234,327 +129,13 @@ async function run() {
   const result = await gr4vy.transactions.create({
     amount: 1299,
     currency: "EUR",
-    country: "US",
-    paymentMethod: {
-      expirationDate: "12/30",
-      number: "4111111111111111",
-      buyerExternalIdentifier: "buyer-12345",
-      buyerId: "fe26475d-ec3e-4884-9553-f7356683f7f9",
-      externalIdentifier: "payment-method-12345",
-      cardType: "credit",
-      securityCode: "123",
-    },
-    buyer: {
-      displayName: "John Doe",
-      externalIdentifier: "buyer-12345",
-      billingDetails: {
-        firstName: "John",
-        lastName: "Doe",
-        emailAddress: "john@example.com",
-        phoneNumber: "+1234567890",
-        address: {
-          city: "San Jose",
-          country: "US",
-          postalCode: "94560",
-          state: "California",
-          stateCode: "US-CA",
-          houseNumberOrName: "10",
-          line1: "Stafford Appartments",
-          line2: "29th Street",
-          organization: "Gr4vy",
-        },
-        taxId: {
-          value: "12345678931",
-          kind: "br.cnpj",
-        },
-      },
-      shippingDetails: {
-        firstName: "John",
-        lastName: "Doe",
-        emailAddress: "john@example.com",
-        phoneNumber: "+1234567890",
-        address: {
-          city: "San Jose",
-          country: "US",
-          postalCode: "94560",
-          state: "California",
-          stateCode: "US-CA",
-          houseNumberOrName: "10",
-          line1: "Stafford Appartments",
-          line2: "29th Street",
-          organization: "Gr4vy",
-        },
-      },
-    },
-    buyerId: "fe26475d-ec3e-4884-9553-f7356683f7f9",
-    buyerExternalIdentifier: "buyer-12345",
-    giftCards: [
-      {
-        id: "356d56e5-fe16-42ae-97ee-8d55d846ae2e",
-        amount: 1299,
-      },
-      {
-        id: "356d56e5-fe16-42ae-97ee-8d55d846ae2e",
-        amount: 1299,
-      },
-      {
-        number: "4123455541234561234",
-        pin: "1234",
-        amount: 1299,
-      },
-    ],
-    externalIdentifier: "transaction-12345",
-    threeDSecureData: {
-      cavv: "3q2+78r+ur7erb7vyv66vv8=",
-      eci: "05",
-      version: "2.1.0",
-      directoryResponse: "C",
-      scheme: "visa",
-      authenticationResponse: "Y",
-      cavvAlgorithm: "A",
-      xid: "12345",
-    },
-    metadata: {
-      "cohort": "cohort-12345",
-      "order": "order-12345",
-    },
-    airline: {
-      bookingCode: "X36Q9C",
-      isCardholderTraveling: true,
-      issuedAddress: "123 Broadway, New York",
-      issuedAt: new Date("2013-07-16T19:23:00.000+00:00"),
-      issuingCarrierCode: "649",
-      issuingCarrierName: "Air Transat A.T. Inc",
-      issuingIataDesignator: "TS",
-      issuingIcaoCode: "TSC",
-      legs: [
-        {
-          arrivalAirport: "LAX",
-          arrivalAt: new Date("2013-07-16T19:23:00.000+00:00"),
-          arrivalCity: "Los Angeles",
-          arrivalCountry: "US",
-          carrierCode: "649",
-          carrierName: "Air Transat A.T. Inc",
-          iataDesignator: "TS",
-          icaoCode: "TSC",
-          couponNumber: "15885566",
-          departureAirport: "LHR",
-          departureAt: new Date("2013-07-16T19:23:00.000+00:00"),
-          departureCity: "London",
-          departureCountry: "GB",
-          departureTaxAmount: 1200,
-          fareAmount: 129900,
-          fareBasisCode: "FY",
-          feeAmount: 1200,
-          flightClass: "E",
-          flightNumber: "101",
-          routeType: "round_trip",
-          seatClass: "F",
-          stopOver: false,
-          taxAmount: 1200,
-        },
-        {
-          arrivalAirport: "LAX",
-          arrivalAt: new Date("2013-07-16T19:23:00.000+00:00"),
-          arrivalCity: "Los Angeles",
-          arrivalCountry: "US",
-          carrierCode: "649",
-          carrierName: "Air Transat A.T. Inc",
-          iataDesignator: "TS",
-          icaoCode: "TSC",
-          couponNumber: "15885566",
-          departureAirport: "LHR",
-          departureAt: new Date("2013-07-16T19:23:00.000+00:00"),
-          departureCity: "London",
-          departureCountry: "GB",
-          departureTaxAmount: 1200,
-          fareAmount: 129900,
-          fareBasisCode: "FY",
-          feeAmount: 1200,
-          flightClass: "E",
-          flightNumber: "101",
-          routeType: "round_trip",
-          seatClass: "F",
-          stopOver: false,
-          taxAmount: 1200,
-        },
-        {
-          arrivalAirport: "LAX",
-          arrivalAt: new Date("2013-07-16T19:23:00.000+00:00"),
-          arrivalCity: "Los Angeles",
-          arrivalCountry: "US",
-          carrierCode: "649",
-          carrierName: "Air Transat A.T. Inc",
-          iataDesignator: "TS",
-          icaoCode: "TSC",
-          couponNumber: "15885566",
-          departureAirport: "LHR",
-          departureAt: new Date("2013-07-16T19:23:00.000+00:00"),
-          departureCity: "London",
-          departureCountry: "GB",
-          departureTaxAmount: 1200,
-          fareAmount: 129900,
-          fareBasisCode: "FY",
-          feeAmount: 1200,
-          flightClass: "E",
-          flightNumber: "101",
-          routeType: "round_trip",
-          seatClass: "F",
-          stopOver: false,
-          taxAmount: 1200,
-        },
-      ],
-      passengerNameRecord: "JOHN L",
-      passengers: [
-        {
-          ageGroup: "adult",
-          dateOfBirth: new RFCDate("2013-07-16"),
-          emailAddress: "john@example.com",
-          firstName: "John",
-          frequentFlyerNumber: "15885566",
-          lastName: "Luhn",
-          passportNumber: "11117700225",
-          phoneNumber: "+1234567890",
-          ticketNumber: "BA1236699999",
-          title: "Mr.",
-          countryCode: "US",
-        },
-        {
-          ageGroup: "adult",
-          dateOfBirth: new RFCDate("2013-07-16"),
-          emailAddress: "john@example.com",
-          firstName: "John",
-          frequentFlyerNumber: "15885566",
-          lastName: "Luhn",
-          passportNumber: "11117700225",
-          phoneNumber: "+1234567890",
-          ticketNumber: "BA1236699999",
-          title: "Mr.",
-          countryCode: "US",
-        },
-        {
-          ageGroup: "adult",
-          dateOfBirth: new RFCDate("2013-07-16"),
-          emailAddress: "john@example.com",
-          firstName: "John",
-          frequentFlyerNumber: "15885566",
-          lastName: "Luhn",
-          passportNumber: "11117700225",
-          phoneNumber: "+1234567890",
-          ticketNumber: "BA1236699999",
-          title: "Mr.",
-          countryCode: "US",
-        },
-      ],
-      reservationSystem: "Amadeus",
-      restrictedTicket: false,
-      ticketDeliveryMethod: "electronic",
-      ticketNumber: "123-1234-151555",
-      travelAgencyCode: "12345",
-      travelAgencyInvoiceNumber: "EG15555155",
-      travelAgencyName: "ACME Agency",
-      travelAgencyPlanName: "B733",
-    },
-    cartItems: [
-      {
-        name: "GoPro HD",
-        quantity: 2,
-        unitAmount: 1299,
-        discountAmount: 0,
-        taxAmount: 0,
-        externalIdentifier: "goprohd",
-        sku: "GPHD1078",
-        productUrl: "https://example.com/catalog/go-pro-hd",
-        imageUrl: "https://example.com/images/go-pro-hd.jpg",
-        categories: [
-          "camera",
-          "travel",
-          "gear",
-        ],
-        productType: "physical",
-        sellerCountry: "US",
-      },
-      {
-        name: "GoPro HD",
-        quantity: 2,
-        unitAmount: 1299,
-        discountAmount: 0,
-        taxAmount: 0,
-        externalIdentifier: "goprohd",
-        sku: "GPHD1078",
-        productUrl: "https://example.com/catalog/go-pro-hd",
-        imageUrl: "https://example.com/images/go-pro-hd.jpg",
-        categories: [
-          "camera",
-          "travel",
-          "gear",
-        ],
-        productType: "physical",
-        sellerCountry: "US",
-      },
-      {
-        name: "GoPro HD",
-        quantity: 2,
-        unitAmount: 1299,
-        discountAmount: 0,
-        taxAmount: 0,
-        externalIdentifier: "goprohd",
-        sku: "GPHD1078",
-        productUrl: "https://example.com/catalog/go-pro-hd",
-        imageUrl: "https://example.com/images/go-pro-hd.jpg",
-        categories: [
-          "camera",
-          "travel",
-          "gear",
-        ],
-        productType: "physical",
-        sellerCountry: "US",
-      },
-    ],
-    statementDescriptor: {
-      name: "ACME",
-      description: "ACME San Jose Electronics",
-      city: "San Jose",
-      country: "US",
-      phoneNumber: "+1234567890",
-      url: "www.example.com",
-    },
-    previousSchemeTransactionId: "123456789012345",
-    browserInfo: {
-      javascriptEnabled: false,
-      javaEnabled: false,
-      language: "<value>",
-      colorDepth: 242405,
-      screenHeight: 557747,
-      screenWidth: 288219,
-      timeZoneOffset: 538274,
-      userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
-      userDevice: "desktop",
-      acceptHeader: "*/*",
-    },
-    shippingDetailsId: "bf8c36ad-02d9-4904-b0f9-a230b149e341",
-    antiFraudFingerprint: "yGeBAFYgFmM=",
-    paymentServiceId: "fffd152a-9532-4087-9a4f-de58754210f0",
-    recipient: {
-      firstName: "",
-      lastName: "",
-      address: {
-        city: "San Jose",
-        country: "US",
-        postalCode: "94560",
-        state: "California",
-        stateCode: "US-CA",
-        houseNumberOrName: "10",
-        line1: "Stafford Appartments",
-        line2: "29th Street",
-        organization: "Gr4vy",
-      },
-      accountNumber: "act12345",
-      dateOfBirth: new RFCDate("1995-12-23"),
-    },
-  }, 1, "<id>", "request-12345");
-
-  // Handle the result
+    store: true,
+    isSubsequentPayment: true,
+    merchantInitiated: true,
+    asyncCapture: true,
+    accountFundingTransaction: true,
+  });
+
   console.log(result);
 }
 
@@ -569,11 +150,11 @@ The standalone function version of this method:
 import { Gr4vyCore } from "@gr4vy/sdk/core.js";
 import { withToken } from "@gr4vy/sdk/lib/auth.js";
 import { transactionsCreate } from "@gr4vy/sdk/funcs/transactionsCreate.js";
-import { RFCDate } from "@gr4vy/sdk/types";
 
 // Use `Gr4vyCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
 const gr4vy = new Gr4vyCore({
+  merchantAccountId: "<id>",
   server: "sandbox",
   id: "example",
   bearerAuth: withToken({
@@ -585,334 +166,18 @@ async function run() {
   const res = await transactionsCreate(gr4vy, {
     amount: 1299,
     currency: "EUR",
-    country: "US",
-    paymentMethod: {
-      expirationDate: "12/30",
-      number: "4111111111111111",
-      buyerExternalIdentifier: "buyer-12345",
-      buyerId: "fe26475d-ec3e-4884-9553-f7356683f7f9",
-      externalIdentifier: "payment-method-12345",
-      cardType: "credit",
-      securityCode: "123",
-    },
-    buyer: {
-      displayName: "John Doe",
-      externalIdentifier: "buyer-12345",
-      billingDetails: {
-        firstName: "John",
-        lastName: "Doe",
-        emailAddress: "john@example.com",
-        phoneNumber: "+1234567890",
-        address: {
-          city: "San Jose",
-          country: "US",
-          postalCode: "94560",
-          state: "California",
-          stateCode: "US-CA",
-          houseNumberOrName: "10",
-          line1: "Stafford Appartments",
-          line2: "29th Street",
-          organization: "Gr4vy",
-        },
-        taxId: {
-          value: "12345678931",
-          kind: "br.cnpj",
-        },
-      },
-      shippingDetails: {
-        firstName: "John",
-        lastName: "Doe",
-        emailAddress: "john@example.com",
-        phoneNumber: "+1234567890",
-        address: {
-          city: "San Jose",
-          country: "US",
-          postalCode: "94560",
-          state: "California",
-          stateCode: "US-CA",
-          houseNumberOrName: "10",
-          line1: "Stafford Appartments",
-          line2: "29th Street",
-          organization: "Gr4vy",
-        },
-      },
-    },
-    buyerId: "fe26475d-ec3e-4884-9553-f7356683f7f9",
-    buyerExternalIdentifier: "buyer-12345",
-    giftCards: [
-      {
-        id: "356d56e5-fe16-42ae-97ee-8d55d846ae2e",
-        amount: 1299,
-      },
-      {
-        id: "356d56e5-fe16-42ae-97ee-8d55d846ae2e",
-        amount: 1299,
-      },
-      {
-        number: "4123455541234561234",
-        pin: "1234",
-        amount: 1299,
-      },
-    ],
-    externalIdentifier: "transaction-12345",
-    threeDSecureData: {
-      cavv: "3q2+78r+ur7erb7vyv66vv8=",
-      eci: "05",
-      version: "2.1.0",
-      directoryResponse: "C",
-      scheme: "visa",
-      authenticationResponse: "Y",
-      cavvAlgorithm: "A",
-      xid: "12345",
-    },
-    metadata: {
-      "cohort": "cohort-12345",
-      "order": "order-12345",
-    },
-    airline: {
-      bookingCode: "X36Q9C",
-      isCardholderTraveling: true,
-      issuedAddress: "123 Broadway, New York",
-      issuedAt: new Date("2013-07-16T19:23:00.000+00:00"),
-      issuingCarrierCode: "649",
-      issuingCarrierName: "Air Transat A.T. Inc",
-      issuingIataDesignator: "TS",
-      issuingIcaoCode: "TSC",
-      legs: [
-        {
-          arrivalAirport: "LAX",
-          arrivalAt: new Date("2013-07-16T19:23:00.000+00:00"),
-          arrivalCity: "Los Angeles",
-          arrivalCountry: "US",
-          carrierCode: "649",
-          carrierName: "Air Transat A.T. Inc",
-          iataDesignator: "TS",
-          icaoCode: "TSC",
-          couponNumber: "15885566",
-          departureAirport: "LHR",
-          departureAt: new Date("2013-07-16T19:23:00.000+00:00"),
-          departureCity: "London",
-          departureCountry: "GB",
-          departureTaxAmount: 1200,
-          fareAmount: 129900,
-          fareBasisCode: "FY",
-          feeAmount: 1200,
-          flightClass: "E",
-          flightNumber: "101",
-          routeType: "round_trip",
-          seatClass: "F",
-          stopOver: false,
-          taxAmount: 1200,
-        },
-        {
-          arrivalAirport: "LAX",
-          arrivalAt: new Date("2013-07-16T19:23:00.000+00:00"),
-          arrivalCity: "Los Angeles",
-          arrivalCountry: "US",
-          carrierCode: "649",
-          carrierName: "Air Transat A.T. Inc",
-          iataDesignator: "TS",
-          icaoCode: "TSC",
-          couponNumber: "15885566",
-          departureAirport: "LHR",
-          departureAt: new Date("2013-07-16T19:23:00.000+00:00"),
-          departureCity: "London",
-          departureCountry: "GB",
-          departureTaxAmount: 1200,
-          fareAmount: 129900,
-          fareBasisCode: "FY",
-          feeAmount: 1200,
-          flightClass: "E",
-          flightNumber: "101",
-          routeType: "round_trip",
-          seatClass: "F",
-          stopOver: false,
-          taxAmount: 1200,
-        },
-        {
-          arrivalAirport: "LAX",
-          arrivalAt: new Date("2013-07-16T19:23:00.000+00:00"),
-          arrivalCity: "Los Angeles",
-          arrivalCountry: "US",
-          carrierCode: "649",
-          carrierName: "Air Transat A.T. Inc",
-          iataDesignator: "TS",
-          icaoCode: "TSC",
-          couponNumber: "15885566",
-          departureAirport: "LHR",
-          departureAt: new Date("2013-07-16T19:23:00.000+00:00"),
-          departureCity: "London",
-          departureCountry: "GB",
-          departureTaxAmount: 1200,
-          fareAmount: 129900,
-          fareBasisCode: "FY",
-          feeAmount: 1200,
-          flightClass: "E",
-          flightNumber: "101",
-          routeType: "round_trip",
-          seatClass: "F",
-          stopOver: false,
-          taxAmount: 1200,
-        },
-      ],
-      passengerNameRecord: "JOHN L",
-      passengers: [
-        {
-          ageGroup: "adult",
-          dateOfBirth: new RFCDate("2013-07-16"),
-          emailAddress: "john@example.com",
-          firstName: "John",
-          frequentFlyerNumber: "15885566",
-          lastName: "Luhn",
-          passportNumber: "11117700225",
-          phoneNumber: "+1234567890",
-          ticketNumber: "BA1236699999",
-          title: "Mr.",
-          countryCode: "US",
-        },
-        {
-          ageGroup: "adult",
-          dateOfBirth: new RFCDate("2013-07-16"),
-          emailAddress: "john@example.com",
-          firstName: "John",
-          frequentFlyerNumber: "15885566",
-          lastName: "Luhn",
-          passportNumber: "11117700225",
-          phoneNumber: "+1234567890",
-          ticketNumber: "BA1236699999",
-          title: "Mr.",
-          countryCode: "US",
-        },
-        {
-          ageGroup: "adult",
-          dateOfBirth: new RFCDate("2013-07-16"),
-          emailAddress: "john@example.com",
-          firstName: "John",
-          frequentFlyerNumber: "15885566",
-          lastName: "Luhn",
-          passportNumber: "11117700225",
-          phoneNumber: "+1234567890",
-          ticketNumber: "BA1236699999",
-          title: "Mr.",
-          countryCode: "US",
-        },
-      ],
-      reservationSystem: "Amadeus",
-      restrictedTicket: false,
-      ticketDeliveryMethod: "electronic",
-      ticketNumber: "123-1234-151555",
-      travelAgencyCode: "12345",
-      travelAgencyInvoiceNumber: "EG15555155",
-      travelAgencyName: "ACME Agency",
-      travelAgencyPlanName: "B733",
-    },
-    cartItems: [
-      {
-        name: "GoPro HD",
-        quantity: 2,
-        unitAmount: 1299,
-        discountAmount: 0,
-        taxAmount: 0,
-        externalIdentifier: "goprohd",
-        sku: "GPHD1078",
-        productUrl: "https://example.com/catalog/go-pro-hd",
-        imageUrl: "https://example.com/images/go-pro-hd.jpg",
-        categories: [
-          "camera",
-          "travel",
-          "gear",
-        ],
-        productType: "physical",
-        sellerCountry: "US",
-      },
-      {
-        name: "GoPro HD",
-        quantity: 2,
-        unitAmount: 1299,
-        discountAmount: 0,
-        taxAmount: 0,
-        externalIdentifier: "goprohd",
-        sku: "GPHD1078",
-        productUrl: "https://example.com/catalog/go-pro-hd",
-        imageUrl: "https://example.com/images/go-pro-hd.jpg",
-        categories: [
-          "camera",
-          "travel",
-          "gear",
-        ],
-        productType: "physical",
-        sellerCountry: "US",
-      },
-      {
-        name: "GoPro HD",
-        quantity: 2,
-        unitAmount: 1299,
-        discountAmount: 0,
-        taxAmount: 0,
-        externalIdentifier: "goprohd",
-        sku: "GPHD1078",
-        productUrl: "https://example.com/catalog/go-pro-hd",
-        imageUrl: "https://example.com/images/go-pro-hd.jpg",
-        categories: [
-          "camera",
-          "travel",
-          "gear",
-        ],
-        productType: "physical",
-        sellerCountry: "US",
-      },
-    ],
-    statementDescriptor: {
-      name: "ACME",
-      description: "ACME San Jose Electronics",
-      city: "San Jose",
-      country: "US",
-      phoneNumber: "+1234567890",
-      url: "www.example.com",
-    },
-    previousSchemeTransactionId: "123456789012345",
-    browserInfo: {
-      javascriptEnabled: false,
-      javaEnabled: false,
-      language: "<value>",
-      colorDepth: 242405,
-      screenHeight: 557747,
-      screenWidth: 288219,
-      timeZoneOffset: 538274,
-      userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
-      userDevice: "desktop",
-      acceptHeader: "*/*",
-    },
-    shippingDetailsId: "bf8c36ad-02d9-4904-b0f9-a230b149e341",
-    antiFraudFingerprint: "yGeBAFYgFmM=",
-    paymentServiceId: "fffd152a-9532-4087-9a4f-de58754210f0",
-    recipient: {
-      firstName: "",
-      lastName: "",
-      address: {
-        city: "San Jose",
-        country: "US",
-        postalCode: "94560",
-        state: "California",
-        stateCode: "US-CA",
-        houseNumberOrName: "10",
-        line1: "Stafford Appartments",
-        line2: "29th Street",
-        organization: "Gr4vy",
-      },
-      accountNumber: "act12345",
-      dateOfBirth: new RFCDate("1995-12-23"),
-    },
-  }, 1, "<id>", "request-12345");
-
-  if (!res.ok) {
-    throw res.error;
+    store: true,
+    isSubsequentPayment: true,
+    merchantInitiated: true,
+    asyncCapture: true,
+    accountFundingTransaction: true,
+  });
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("transactionsCreate failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -923,7 +188,6 @@ run();
 | Parameter                                                                                                                                                                                             | Type                                                                                                                                                                                                  | Required                                                                                                                                                                                              | Description                                                                                                                                                                                           | Example                                                                                                                                                                                               |
 | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `transactionCreate`                                                                                                                                                                                   | [components.TransactionCreate](../../models/components/transactioncreate.md)                                                                                                                          | :heavy_check_mark:                                                                                                                                                                                    | N/A                                                                                                                                                                                                   |                                                                                                                                                                                                       |
-| `timeoutInSeconds`                                                                                                                                                                                    | *number*                                                                                                                                                                                              | :heavy_minus_sign:                                                                                                                                                                                    | N/A                                                                                                                                                                                                   |                                                                                                                                                                                                       |
 | `merchantAccountId`                                                                                                                                                                                   | *string*                                                                                                                                                                                              | :heavy_minus_sign:                                                                                                                                                                                    | The ID of the merchant account to use for this request.                                                                                                                                               |                                                                                                                                                                                                       |
 | `idempotencyKey`                                                                                                                                                                                      | *string*                                                                                                                                                                                              | :heavy_minus_sign:                                                                                                                                                                                    | A unique key that identifies this request. Providing this header will make this an idempotent request. We recommend using V4 UUIDs, or another random string with enough entropy to avoid collisions. | [object Object]                                                                                                                                                                                       |
 | `options`                                                                                                                                                                                             | RequestOptions                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                    | Used to set various options for making HTTP requests.                                                                                                                                                 |                                                                                                                                                                                                       |
@@ -954,7 +218,7 @@ run();
 
 ## get
 
-Fetch a single transaction by its ID.
+Retrieve the details of a transaction by its unique identifier.
 
 ### Example Usage
 
@@ -962,6 +226,7 @@ Fetch a single transaction by its ID.
 import { Gr4vy } from "@gr4vy/sdk";
 
 const gr4vy = new Gr4vy({
+  merchantAccountId: "<id>",
   server: "sandbox",
   id: "example",
   bearerAuth: withToken({
@@ -970,9 +235,8 @@ const gr4vy = new Gr4vy({
 });
 
 async function run() {
-  const result = await gr4vy.transactions.get("bde12786-dce8-4654-b031-196961d1ddcc");
+  const result = await gr4vy.transactions.get("7099948d-7286-47e4-aad8-b68f7eb44591");
 
-  // Handle the result
   console.log(result);
 }
 
@@ -991,6 +255,7 @@ import { transactionsGet } from "@gr4vy/sdk/funcs/transactionsGet.js";
 // Use `Gr4vyCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
 const gr4vy = new Gr4vyCore({
+  merchantAccountId: "<id>",
   server: "sandbox",
   id: "example",
   bearerAuth: withToken({
@@ -999,16 +264,13 @@ const gr4vy = new Gr4vyCore({
 });
 
 async function run() {
-  const res = await transactionsGet(gr4vy, "bde12786-dce8-4654-b031-196961d1ddcc");
-
-  if (!res.ok) {
-    throw res.error;
+  const res = await transactionsGet(gr4vy, "7099948d-7286-47e4-aad8-b68f7eb44591");
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("transactionsGet failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -1016,13 +278,13 @@ run();
 
 ### Parameters
 
-| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
-| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `transactionId`                                                                                                                                                                | *string*                                                                                                                                                                       | :heavy_check_mark:                                                                                                                                                             | N/A                                                                                                                                                                            |
-| `merchantAccountId`                                                                                                                                                            | *string*                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                             | The ID of the merchant account to use for this request.                                                                                                                        |
-| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
-| `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
-| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    | Example                                                                                                                                                                        |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `transactionId`                                                                                                                                                                | *string*                                                                                                                                                                       | :heavy_check_mark:                                                                                                                                                             | The ID of the transaction                                                                                                                                                      | [object Object]                                                                                                                                                                |
+| `merchantAccountId`                                                                                                                                                            | *string*                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                             | The ID of the merchant account to use for this request.                                                                                                                        |                                                                                                                                                                                |
+| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |                                                                                                                                                                                |
+| `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |                                                                                                                                                                                |
+| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |                                                                                                                                                                                |
 
 ### Response
 
@@ -1048,15 +310,15 @@ run();
 
 ## capture
 
-Capture a previously authorized transaction.
+Captures a previously authorized transaction. You can capture the full or a partial amount, as long as it does not exceed the authorized amount (unless over-capture is enabled).
 
 ### Example Usage
 
 ```typescript
 import { Gr4vy } from "@gr4vy/sdk";
-import { RFCDate } from "@gr4vy/sdk/types";
 
 const gr4vy = new Gr4vy({
+  merchantAccountId: "<id>",
   server: "sandbox",
   id: "example",
   bearerAuth: withToken({
@@ -1065,135 +327,8 @@ const gr4vy = new Gr4vy({
 });
 
 async function run() {
-  const result = await gr4vy.transactions.capture({
-    amount: 1299,
-    airline: {
-      bookingCode: "X36Q9C",
-      isCardholderTraveling: true,
-      issuedAddress: "123 Broadway, New York",
-      issuedAt: new Date("2013-07-16T19:23:00.000+00:00"),
-      issuingCarrierCode: "649",
-      issuingCarrierName: "Air Transat A.T. Inc",
-      issuingIataDesignator: "TS",
-      issuingIcaoCode: "TSC",
-      legs: [
-        {
-          arrivalAirport: "LAX",
-          arrivalAt: new Date("2013-07-16T19:23:00.000+00:00"),
-          arrivalCity: "Los Angeles",
-          arrivalCountry: "US",
-          carrierCode: "649",
-          carrierName: "Air Transat A.T. Inc",
-          iataDesignator: "TS",
-          icaoCode: "TSC",
-          couponNumber: "15885566",
-          departureAirport: "LHR",
-          departureAt: new Date("2013-07-16T19:23:00.000+00:00"),
-          departureCity: "London",
-          departureCountry: "GB",
-          departureTaxAmount: 1200,
-          fareAmount: 129900,
-          fareBasisCode: "FY",
-          feeAmount: 1200,
-          flightClass: "E",
-          flightNumber: "101",
-          routeType: "round_trip",
-          seatClass: "F",
-          stopOver: false,
-          taxAmount: 1200,
-        },
-        {
-          arrivalAirport: "LAX",
-          arrivalAt: new Date("2013-07-16T19:23:00.000+00:00"),
-          arrivalCity: "Los Angeles",
-          arrivalCountry: "US",
-          carrierCode: "649",
-          carrierName: "Air Transat A.T. Inc",
-          iataDesignator: "TS",
-          icaoCode: "TSC",
-          couponNumber: "15885566",
-          departureAirport: "LHR",
-          departureAt: new Date("2013-07-16T19:23:00.000+00:00"),
-          departureCity: "London",
-          departureCountry: "GB",
-          departureTaxAmount: 1200,
-          fareAmount: 129900,
-          fareBasisCode: "FY",
-          feeAmount: 1200,
-          flightClass: "E",
-          flightNumber: "101",
-          routeType: "round_trip",
-          seatClass: "F",
-          stopOver: false,
-          taxAmount: 1200,
-        },
-        {
-          arrivalAirport: "LAX",
-          arrivalAt: new Date("2013-07-16T19:23:00.000+00:00"),
-          arrivalCity: "Los Angeles",
-          arrivalCountry: "US",
-          carrierCode: "649",
-          carrierName: "Air Transat A.T. Inc",
-          iataDesignator: "TS",
-          icaoCode: "TSC",
-          couponNumber: "15885566",
-          departureAirport: "LHR",
-          departureAt: new Date("2013-07-16T19:23:00.000+00:00"),
-          departureCity: "London",
-          departureCountry: "GB",
-          departureTaxAmount: 1200,
-          fareAmount: 129900,
-          fareBasisCode: "FY",
-          feeAmount: 1200,
-          flightClass: "E",
-          flightNumber: "101",
-          routeType: "round_trip",
-          seatClass: "F",
-          stopOver: false,
-          taxAmount: 1200,
-        },
-      ],
-      passengerNameRecord: "JOHN L",
-      passengers: [
-        {
-          ageGroup: "adult",
-          dateOfBirth: new RFCDate("2013-07-16"),
-          emailAddress: "john@example.com",
-          firstName: "John",
-          frequentFlyerNumber: "15885566",
-          lastName: "Luhn",
-          passportNumber: "11117700225",
-          phoneNumber: "+1234567890",
-          ticketNumber: "BA1236699999",
-          title: "Mr.",
-          countryCode: "US",
-        },
-        {
-          ageGroup: "adult",
-          dateOfBirth: new RFCDate("2013-07-16"),
-          emailAddress: "john@example.com",
-          firstName: "John",
-          frequentFlyerNumber: "15885566",
-          lastName: "Luhn",
-          passportNumber: "11117700225",
-          phoneNumber: "+1234567890",
-          ticketNumber: "BA1236699999",
-          title: "Mr.",
-          countryCode: "US",
-        },
-      ],
-      reservationSystem: "Amadeus",
-      restrictedTicket: false,
-      ticketDeliveryMethod: "electronic",
-      ticketNumber: "123-1234-151555",
-      travelAgencyCode: "12345",
-      travelAgencyInvoiceNumber: "EG15555155",
-      travelAgencyName: "ACME Agency",
-      travelAgencyPlanName: "B733",
-    },
-  }, "9a049029-b958-45dd-86d7-d7f9fc92c411");
-
-  // Handle the result
+  const result = await gr4vy.transactions.capture({}, "7099948d-7286-47e4-aad8-b68f7eb44591");
+
   console.log(result);
 }
 
@@ -1208,11 +343,11 @@ The standalone function version of this method:
 import { Gr4vyCore } from "@gr4vy/sdk/core.js";
 import { withToken } from "@gr4vy/sdk/lib/auth.js";
 import { transactionsCapture } from "@gr4vy/sdk/funcs/transactionsCapture.js";
-import { RFCDate } from "@gr4vy/sdk/types";
 
 // Use `Gr4vyCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
 const gr4vy = new Gr4vyCore({
+  merchantAccountId: "<id>",
   server: "sandbox",
   id: "example",
   bearerAuth: withToken({
@@ -1221,142 +356,13 @@ const gr4vy = new Gr4vyCore({
 });
 
 async function run() {
-  const res = await transactionsCapture(gr4vy, {
-    amount: 1299,
-    airline: {
-      bookingCode: "X36Q9C",
-      isCardholderTraveling: true,
-      issuedAddress: "123 Broadway, New York",
-      issuedAt: new Date("2013-07-16T19:23:00.000+00:00"),
-      issuingCarrierCode: "649",
-      issuingCarrierName: "Air Transat A.T. Inc",
-      issuingIataDesignator: "TS",
-      issuingIcaoCode: "TSC",
-      legs: [
-        {
-          arrivalAirport: "LAX",
-          arrivalAt: new Date("2013-07-16T19:23:00.000+00:00"),
-          arrivalCity: "Los Angeles",
-          arrivalCountry: "US",
-          carrierCode: "649",
-          carrierName: "Air Transat A.T. Inc",
-          iataDesignator: "TS",
-          icaoCode: "TSC",
-          couponNumber: "15885566",
-          departureAirport: "LHR",
-          departureAt: new Date("2013-07-16T19:23:00.000+00:00"),
-          departureCity: "London",
-          departureCountry: "GB",
-          departureTaxAmount: 1200,
-          fareAmount: 129900,
-          fareBasisCode: "FY",
-          feeAmount: 1200,
-          flightClass: "E",
-          flightNumber: "101",
-          routeType: "round_trip",
-          seatClass: "F",
-          stopOver: false,
-          taxAmount: 1200,
-        },
-        {
-          arrivalAirport: "LAX",
-          arrivalAt: new Date("2013-07-16T19:23:00.000+00:00"),
-          arrivalCity: "Los Angeles",
-          arrivalCountry: "US",
-          carrierCode: "649",
-          carrierName: "Air Transat A.T. Inc",
-          iataDesignator: "TS",
-          icaoCode: "TSC",
-          couponNumber: "15885566",
-          departureAirport: "LHR",
-          departureAt: new Date("2013-07-16T19:23:00.000+00:00"),
-          departureCity: "London",
-          departureCountry: "GB",
-          departureTaxAmount: 1200,
-          fareAmount: 129900,
-          fareBasisCode: "FY",
-          feeAmount: 1200,
-          flightClass: "E",
-          flightNumber: "101",
-          routeType: "round_trip",
-          seatClass: "F",
-          stopOver: false,
-          taxAmount: 1200,
-        },
-        {
-          arrivalAirport: "LAX",
-          arrivalAt: new Date("2013-07-16T19:23:00.000+00:00"),
-          arrivalCity: "Los Angeles",
-          arrivalCountry: "US",
-          carrierCode: "649",
-          carrierName: "Air Transat A.T. Inc",
-          iataDesignator: "TS",
-          icaoCode: "TSC",
-          couponNumber: "15885566",
-          departureAirport: "LHR",
-          departureAt: new Date("2013-07-16T19:23:00.000+00:00"),
-          departureCity: "London",
-          departureCountry: "GB",
-          departureTaxAmount: 1200,
-          fareAmount: 129900,
-          fareBasisCode: "FY",
-          feeAmount: 1200,
-          flightClass: "E",
-          flightNumber: "101",
-          routeType: "round_trip",
-          seatClass: "F",
-          stopOver: false,
-          taxAmount: 1200,
-        },
-      ],
-      passengerNameRecord: "JOHN L",
-      passengers: [
-        {
-          ageGroup: "adult",
-          dateOfBirth: new RFCDate("2013-07-16"),
-          emailAddress: "john@example.com",
-          firstName: "John",
-          frequentFlyerNumber: "15885566",
-          lastName: "Luhn",
-          passportNumber: "11117700225",
-          phoneNumber: "+1234567890",
-          ticketNumber: "BA1236699999",
-          title: "Mr.",
-          countryCode: "US",
-        },
-        {
-          ageGroup: "adult",
-          dateOfBirth: new RFCDate("2013-07-16"),
-          emailAddress: "john@example.com",
-          firstName: "John",
-          frequentFlyerNumber: "15885566",
-          lastName: "Luhn",
-          passportNumber: "11117700225",
-          phoneNumber: "+1234567890",
-          ticketNumber: "BA1236699999",
-          title: "Mr.",
-          countryCode: "US",
-        },
-      ],
-      reservationSystem: "Amadeus",
-      restrictedTicket: false,
-      ticketDeliveryMethod: "electronic",
-      ticketNumber: "123-1234-151555",
-      travelAgencyCode: "12345",
-      travelAgencyInvoiceNumber: "EG15555155",
-      travelAgencyName: "ACME Agency",
-      travelAgencyPlanName: "B733",
-    },
-  }, "9a049029-b958-45dd-86d7-d7f9fc92c411");
-
-  if (!res.ok) {
-    throw res.error;
+  const res = await transactionsCapture(gr4vy, {}, "7099948d-7286-47e4-aad8-b68f7eb44591");
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("transactionsCapture failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -1364,15 +370,14 @@ run();
 
 ### Parameters
 
-| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
-| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `transactionId`                                                                                                                                                                | *string*                                                                                                                                                                       | :heavy_check_mark:                                                                                                                                                             | N/A                                                                                                                                                                            |
-| `transactionCapture`                                                                                                                                                           | [components.TransactionCapture](../../models/components/transactioncapture.md)                                                                                                 | :heavy_check_mark:                                                                                                                                                             | N/A                                                                                                                                                                            |
-| `timeoutInSeconds`                                                                                                                                                             | *number*                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                             | N/A                                                                                                                                                                            |
-| `merchantAccountId`                                                                                                                                                            | *string*                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                             | The ID of the merchant account to use for this request.                                                                                                                        |
-| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
-| `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
-| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    | Example                                                                                                                                                                        |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `transactionId`                                                                                                                                                                | *string*                                                                                                                                                                       | :heavy_check_mark:                                                                                                                                                             | The ID of the transaction                                                                                                                                                      | [object Object]                                                                                                                                                                |
+| `transactionCapture`                                                                                                                                                           | [components.TransactionCapture](../../models/components/transactioncapture.md)                                                                                                 | :heavy_check_mark:                                                                                                                                                             | N/A                                                                                                                                                                            |                                                                                                                                                                                |
+| `merchantAccountId`                                                                                                                                                            | *string*                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                             | The ID of the merchant account to use for this request.                                                                                                                        |                                                                                                                                                                                |
+| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |                                                                                                                                                                                |
+| `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |                                                                                                                                                                                |
+| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |                                                                                                                                                                                |
 
 ### Response
 
@@ -1398,7 +403,7 @@ run();
 
 ## void
 
-Void a previously authorized transaction.
+Voids a previously authorized transaction. If the transaction was not yet successfully authorized, or was already captured, the void will not be processed. This operation releases the hold on the buyer's funds. Captured transactions can be refunded instead.
 
 ### Example Usage
 
@@ -1406,6 +411,7 @@ Void a previously authorized transaction.
 import { Gr4vy } from "@gr4vy/sdk";
 
 const gr4vy = new Gr4vy({
+  merchantAccountId: "<id>",
   server: "sandbox",
   id: "example",
   bearerAuth: withToken({
@@ -1414,9 +420,8 @@ const gr4vy = new Gr4vy({
 });
 
 async function run() {
-  const result = await gr4vy.transactions.void("7dbc44c9-1ea3-4853-87be-9923dd281b0d");
+  const result = await gr4vy.transactions.void("7099948d-7286-47e4-aad8-b68f7eb44591");
 
-  // Handle the result
   console.log(result);
 }
 
@@ -1435,6 +440,7 @@ import { transactionsVoid } from "@gr4vy/sdk/funcs/transactionsVoid.js";
 // Use `Gr4vyCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
 const gr4vy = new Gr4vyCore({
+  merchantAccountId: "<id>",
   server: "sandbox",
   id: "example",
   bearerAuth: withToken({
@@ -1443,111 +449,13 @@ const gr4vy = new Gr4vyCore({
 });
 
 async function run() {
-  const res = await transactionsVoid(gr4vy, "7dbc44c9-1ea3-4853-87be-9923dd281b0d");
-
-  if (!res.ok) {
-    throw res.error;
+  const res = await transactionsVoid(gr4vy, "7099948d-7286-47e4-aad8-b68f7eb44591");
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("transactionsVoid failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
-}
-
-run();
-```
-
-### Parameters
-
-| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
-| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `transactionId`                                                                                                                                                                | *string*                                                                                                                                                                       | :heavy_check_mark:                                                                                                                                                             | N/A                                                                                                                                                                            |
-| `timeoutInSeconds`                                                                                                                                                             | *number*                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                             | N/A                                                                                                                                                                            |
-| `merchantAccountId`                                                                                                                                                            | *string*                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                             | The ID of the merchant account to use for this request.                                                                                                                        |
-| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
-| `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
-| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
-
-### Response
-
-**Promise\<[components.Transaction](../../models/components/transaction.md)\>**
-
-### Errors
-
-| Error Type                 | Status Code                | Content Type               |
-| -------------------------- | -------------------------- | -------------------------- |
-| errors.Error400            | 400                        | application/json           |
-| errors.Error401            | 401                        | application/json           |
-| errors.Error403            | 403                        | application/json           |
-| errors.Error404            | 404                        | application/json           |
-| errors.Error405            | 405                        | application/json           |
-| errors.Error409            | 409                        | application/json           |
-| errors.HTTPValidationError | 422                        | application/json           |
-| errors.Error425            | 425                        | application/json           |
-| errors.Error429            | 429                        | application/json           |
-| errors.Error500            | 500                        | application/json           |
-| errors.Error502            | 502                        | application/json           |
-| errors.Error504            | 504                        | application/json           |
-| errors.SDKError            | 4XX, 5XX                   | \*/\*                      |
-
-## summary
-
-Fetch a summary for a transaction.
-
-### Example Usage
-
-```typescript
-import { Gr4vy } from "@gr4vy/sdk";
-
-const gr4vy = new Gr4vy({
-  server: "sandbox",
-  id: "example",
-  bearerAuth: withToken({
-    privateKey: fs.readFileSync("private_key.pem", "utf8"),
-  }),
-});
-
-async function run() {
-  const result = await gr4vy.transactions.summary("7099948d-7286-47e4-aad8-b68f7eb44591");
-
-  // Handle the result
-  console.log(result);
-}
-
-run();
-```
-
-### Standalone function
-
-The standalone function version of this method:
-
-```typescript
-import { Gr4vyCore } from "@gr4vy/sdk/core.js";
-import { withToken } from "@gr4vy/sdk/lib/auth.js";
-import { transactionsSummary } from "@gr4vy/sdk/funcs/transactionsSummary.js";
-
-// Use `Gr4vyCore` for best tree-shaking performance.
-// You can create one instance of it to use across an application.
-const gr4vy = new Gr4vyCore({
-  server: "sandbox",
-  id: "example",
-  bearerAuth: withToken({
-    privateKey: fs.readFileSync("private_key.pem", "utf8"),
-  }),
-});
-
-async function run() {
-  const res = await transactionsSummary(gr4vy, "7099948d-7286-47e4-aad8-b68f7eb44591");
-
-  if (!res.ok) {
-    throw res.error;
-  }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -1557,7 +465,7 @@ run();
 
 | Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    | Example                                                                                                                                                                        |
 | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `transactionId`                                                                                                                                                                | *string*                                                                                                                                                                       | :heavy_check_mark:                                                                                                                                                             | N/A                                                                                                                                                                            | [object Object]                                                                                                                                                                |
+| `transactionId`                                                                                                                                                                | *string*                                                                                                                                                                       | :heavy_check_mark:                                                                                                                                                             | The ID of the transaction                                                                                                                                                      | [object Object]                                                                                                                                                                |
 | `merchantAccountId`                                                                                                                                                            | *string*                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                             | The ID of the merchant account to use for this request.                                                                                                                        |                                                                                                                                                                                |
 | `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |                                                                                                                                                                                |
 | `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |                                                                                                                                                                                |
@@ -1565,7 +473,7 @@ run();
 
 ### Response
 
-**Promise\<[components.TransactionStatusSummary](../../models/components/transactionstatussummary.md)\>**
+**Promise\<[components.Transaction](../../models/components/transaction.md)\>**
 
 ### Errors
 
@@ -1587,7 +495,7 @@ run();
 
 ## sync
 
-Fetch the latest status for a transaction.
+Synchronizes the status of a transaction with the underlying payment service provider. This is useful for transactions in a pending state to check if they've been completed or failed. Only available for some payment service providers.
 
 ### Example Usage
 
@@ -1595,6 +503,7 @@ Fetch the latest status for a transaction.
 import { Gr4vy } from "@gr4vy/sdk";
 
 const gr4vy = new Gr4vy({
+  merchantAccountId: "<id>",
   server: "sandbox",
   id: "example",
   bearerAuth: withToken({
@@ -1605,7 +514,6 @@ const gr4vy = new Gr4vy({
 async function run() {
   const result = await gr4vy.transactions.sync("2ee546e0-3b11-478e-afec-fdb362611e22");
 
-  // Handle the result
   console.log(result);
 }
 
@@ -1624,6 +532,7 @@ import { transactionsSync } from "@gr4vy/sdk/funcs/transactionsSync.js";
 // Use `Gr4vyCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
 const gr4vy = new Gr4vyCore({
+  merchantAccountId: "<id>",
   server: "sandbox",
   id: "example",
   bearerAuth: withToken({
@@ -1633,15 +542,12 @@ const gr4vy = new Gr4vyCore({
 
 async function run() {
   const res = await transactionsSync(gr4vy, "2ee546e0-3b11-478e-afec-fdb362611e22");
-
-  if (!res.ok) {
-    throw res.error;
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("transactionsSync failed:", res.error);
   }
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();
@@ -1652,7 +558,6 @@ run();
 | Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
 | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | `transactionId`                                                                                                                                                                | *string*                                                                                                                                                                       | :heavy_check_mark:                                                                                                                                                             | N/A                                                                                                                                                                            |
-| `timeoutInSeconds`                                                                                                                                                             | *number*                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                             | N/A                                                                                                                                                                            |
 | `merchantAccountId`                                                                                                                                                            | *string*                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                             | The ID of the merchant account to use for this request.                                                                                                                        |
 | `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
 | `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |