platform-types 1.10.795 → 1.10.796

package/dist/cjs/paymentAttempt.js

@@ -19,7 +19,7 @@
  * no operator write can carry it back onto the order.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PAYMENT_HOLD_MINUTES_DEFAULT = exports.PAYMENT_HOLD_MINUTES_MAX = exports.PAYMENT_HOLD_MINUTES_MIN = exports.PAYMENT_ATTEMPT_RESOLUTION_CAUSES = exports.ORDER_NOT_PAYABLE_REASONS = exports.PAYMENT_ATTEMPT_RESOLUTION_REASON_MAX = exports.PAYMENT_ATTEMPT_RESOLUTION_OUTCOMES = exports.PAYMENT_ATTEMPT_ERROR_CODES = exports.PAYMENT_ATTEMPT_STATES = void 0;
+exports.PAYMENT_HOLD_MINUTES_DEFAULT = exports.PAYMENT_HOLD_MINUTES_MAX = exports.PAYMENT_HOLD_MINUTES_MIN = exports.PAYMENT_ATTEMPT_RESOLUTION_CAUSES = exports.ORDER_NOT_PAYABLE_REASONS = exports.PAYMENT_ATTEMPT_RESOLUTION_REASON_MAX = exports.PAYMENT_ATTEMPT_RESOLUTION_OUTCOMES = exports.GUEST_PAYMENT_ERROR_CODES = exports.PAYMENT_ATTEMPT_ERROR_CODES = exports.PAYMENT_ATTEMPT_STATES = void 0;
 /** Every {@link PaymentAttemptState}, in lifecycle order. */
 exports.PAYMENT_ATTEMPT_STATES = [
     'created',
@@ -71,6 +71,20 @@ exports.PAYMENT_ATTEMPT_ERROR_CODES = [
     'PAYMENT_ATTEMPT_NOT_IN_RESOLUTION',
     'PAYMENT_ATTEMPT_CHANGED',
 ];
+/**
+ * The refusal the guest payment start (`POST /payments/attempts/guest`) answers
+ * itself, beside every {@link PAYMENT_ATTEMPT_ERROR_CODES} entry it shares with
+ * the signed-in start.
+ *
+ * - `GUEST_PAYMENT_GRANT_INVALID` · 401 — every reason the grant cannot be
+ *   honoured: missing, tampered, another version (a guest STATUS token
+ *   included), expired (7 days after it was issued), minted for another order
+ *   or another store, presented on another store's host, or naming an order
+ *   that is not — or is no longer — an unattached guest order (attached to an
+ *   account, its buyer then pays signed in). One identical body, so the grant is
+ *   never an oracle.
+ */
+exports.GUEST_PAYMENT_ERROR_CODES = ['GUEST_PAYMENT_GRANT_INVALID'];
 /**
  * Every `outcome` of {@link ResolvePaymentAttemptRequest}:
  *

package/dist/order.d.ts

@@ -2494,6 +2494,24 @@ declare global {
         expectedCartId: string;
         expectedCartVersion: number;
     }
+    /**
+     * `data` of a successful Web `POST /orders/guest`: the placed order, as the
+     * signed-in checkout answers it (the storefront reads `orderId`), plus the
+     * guest's payment grant.
+     */
+    interface StorefrontGuestOrderCreateResponse extends Partial<Order> {
+        orderId: string;
+        /**
+         * The guest payment grant (`gp1.…`) for THIS order, valid 7 days: the
+         * credential `POST /payments/attempts/guest` takes
+         * ({@link StartGuestPaymentAttemptRequest}). Present only when the order
+         * can be paid online when the answer is built (its payment method row
+         * declares `storefront: 'mp-checkout-pro'`, pesos, something to charge) and
+         * the grant could be minted; absent otherwise. A replay of the checkout
+         * answers a freshly minted one. Keep it in memory or the URL fragment only.
+         */
+        paymentGrant?: string;
+    }
     interface ZebraTag {
         orderId: string;
         fullName: string;

package/dist/paymentAttempt.d.ts

@@ -57,6 +57,8 @@ declare global {
     type PaymentAttemptState = (typeof PAYMENT_ATTEMPT_STATES)[number];
     /** One of {@link PAYMENT_ATTEMPT_ERROR_CODES}. */
     type PaymentAttemptErrorCode = (typeof PAYMENT_ATTEMPT_ERROR_CODES)[number];
+    /** One of {@link GUEST_PAYMENT_ERROR_CODES}. */
+    type GuestPaymentErrorCode = (typeof GUEST_PAYMENT_ERROR_CODES)[number];
     /** One of {@link ORDER_NOT_PAYABLE_REASONS}. */
     type OrderNotPayableReason = (typeof ORDER_NOT_PAYABLE_REASONS)[number];
     /** One of {@link PAYMENT_ATTEMPT_RESOLUTION_CAUSES}. */
@@ -71,6 +73,22 @@ declare global {
     interface StartPaymentAttemptRequest {
         orderId: string;
     }
+    /**
+     * Web `POST /payments/attempts/guest` body: a buyer with NO account starts
+     * (or gets back the live) payment attempt of one guest order. Answers
+     * {@link StartPaymentAttemptResponse}, with every {@link PAYMENT_ATTEMPT_ERROR_CODES}
+     * refusal the signed-in start answers, plus {@link GUEST_PAYMENT_ERROR_CODES}.
+     */
+    interface StartGuestPaymentAttemptRequest {
+        orderId: string;
+        /**
+         * The guest payment grant (`gp1.…`) the guest checkout answered
+         * (`StorefrontGuestOrderCreateResponse.paymentGrant`) or the order email's
+         * "Pagar" link carried in its `#pagar=` fragment. A bearer credential:
+         * never put it in a URL a server or Mercado Pago sees, nor in `back_urls`.
+         */
+        paymentGrant: string;
+    }
     /** `data` of a successful start. A repeat start while the attempt is live answers the same `attemptId`. */
     interface StartPaymentAttemptResponse {
         attemptId: string;
@@ -237,6 +255,20 @@ export declare const PAYMENT_ATTEMPT_STATES: readonly ["created", "pending", "ap
  *   written; `data` is {@link PaymentAttemptChangedData}.
  */
 export declare const PAYMENT_ATTEMPT_ERROR_CODES: readonly ["PAYMENT_PROVIDER_NOT_CONNECTED", "PAYMENT_PROVIDER_TOKEN_EXPIRED", "ORDER_NOT_PAYABLE", "PAYMENT_ATTEMPT_EXPIRED", "PAYMENT_METHOD_UNAVAILABLE", "MP_PREFERENCE_CREATE_FAILED", "PAYMENT_ATTEMPT_NOT_FOUND", "PAYMENT_ATTEMPT_NOT_IN_RESOLUTION", "PAYMENT_ATTEMPT_CHANGED"];
+/**
+ * The refusal the guest payment start (`POST /payments/attempts/guest`) answers
+ * itself, beside every {@link PAYMENT_ATTEMPT_ERROR_CODES} entry it shares with
+ * the signed-in start.
+ *
+ * - `GUEST_PAYMENT_GRANT_INVALID` · 401 — every reason the grant cannot be
+ *   honoured: missing, tampered, another version (a guest STATUS token
+ *   included), expired (7 days after it was issued), minted for another order
+ *   or another store, presented on another store's host, or naming an order
+ *   that is not — or is no longer — an unattached guest order (attached to an
+ *   account, its buyer then pays signed in). One identical body, so the grant is
+ *   never an oracle.
+ */
+export declare const GUEST_PAYMENT_ERROR_CODES: readonly ["GUEST_PAYMENT_GRANT_INVALID"];
 /**
  * Every `outcome` of {@link ResolvePaymentAttemptRequest}:
  *

package/dist/paymentAttempt.js

@@ -68,6 +68,20 @@ export const PAYMENT_ATTEMPT_ERROR_CODES = [
     'PAYMENT_ATTEMPT_NOT_IN_RESOLUTION',
     'PAYMENT_ATTEMPT_CHANGED',
 ];
+/**
+ * The refusal the guest payment start (`POST /payments/attempts/guest`) answers
+ * itself, beside every {@link PAYMENT_ATTEMPT_ERROR_CODES} entry it shares with
+ * the signed-in start.
+ *
+ * - `GUEST_PAYMENT_GRANT_INVALID` · 401 — every reason the grant cannot be
+ *   honoured: missing, tampered, another version (a guest STATUS token
+ *   included), expired (7 days after it was issued), minted for another order
+ *   or another store, presented on another store's host, or naming an order
+ *   that is not — or is no longer — an unattached guest order (attached to an
+ *   account, its buyer then pays signed in). One identical body, so the grant is
+ *   never an oracle.
+ */
+export const GUEST_PAYMENT_ERROR_CODES = ['GUEST_PAYMENT_GRANT_INVALID'];
 /**
  * Every `outcome` of {@link ResolvePaymentAttemptRequest}:
  *

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "platform-types",
-	"version": "1.10.795",
+	"version": "1.10.796",
 	"description": "Shared wire and entity contracts for the platform.",
 	"type": "module",
 	"main": "dist/index.js",