@p2pdotme/sdk 1.2.19 → 1.2.21

package/dist/country.d.cts

@@ -72,11 +72,25 @@ interface CountryOption {
     readonly uploadPaymentQR?: boolean;
     /** Structural check for a standalone QR payload (no `||` pack). */
     readonly validateQr?: (payload: string) => boolean;
+    /**
+     * PAY display: payload to re-draw a stored QR. May be looser than
+     * `validateQr` so old orders still render (e.g. Yape/Plin without CRC,
+     * Pago Móvil without `merchantId`). Scan & Pay uses `validateQr` /
+     * parsers, not this hook. Apps call `getPayQrPayload(currency, id)` —
+     * do not branch on currency.
+     */
+    readonly getPayQrPayload?: (paymentId: string) => string | null;
     /**
      * Fill catalog fields from a validated QR (e.g. Yape/Plin phone in EMVCo).
      * Only used when the typed fallback did not already set the key.
      */
     readonly hydrateFieldsFromQr?: (qr: string) => Partial<Record<string, string>>;
+    /**
+     * i18n key for a warning shown before the payer sends fiat (e.g. a bank
+     * outage). Apps call `getTransferWarning(currency)` — do not branch on
+     * currency. Omit when there is no warning.
+     */
+    readonly transferWarning?: string;
 }
 
 /** All supported countries with their currency metadata, payment methods, and display config. */
@@ -93,18 +107,23 @@ declare function uploadsPaymentQR(currency: CurrencyCode | null | undefined): bo
  */
 declare function usesPackedPaymentId(currency: CurrencyCode | null | undefined): boolean;
 /**
- * Apps mount the catalog form (PackedPaymentInput): QR upload and/or
- * more than one typed field.
+ * Apps mount the catalog form (PackedPaymentInput): QR upload and typed
+ * fields may both show — they are not exclusive.
  */
 declare function usesCatalogPaymentForm(currency: CurrencyCode | null | undefined): boolean;
+/**
+ * i18n key for a warning shown before the payer sends fiat, or `null` when the
+ * currency has none. Apps translate with `t(key)` — do not branch on currency.
+ */
+declare function getTransferWarning(currency: CurrencyCode | null | undefined): string | null;
 
 /** Payment ID field configuration for each supported currency. */
 declare const PAYMENT_ID_FIELDS: Record<CurrencyCode, PaymentIdFieldConfig[]>;
 
 /**
  * Yape/Plin EMVCo: country PE, currency 604, CRC-16/CCITT-FALSE.
- * CRC is required on upload so we never persist a truncated screenshot.
- * (PAY render in the merchant is looser; that path does not use this.)
+ * Same rule for SELL upload and Scan & Pay (`parsePeru`).
+ * `getPayQrPayload` may still re-draw a stored blob whose CRC later fails.
  */
 declare function validatePeruvianQr(payload: string): boolean;
 /**
@@ -118,7 +137,8 @@ declare function validateBolivianQr(payload: string): boolean;
  * Suiche 7B / Pago Móvil collection QR: `base64?merchantId=NNNN&…`.
  * The base64 is bank AES — we cannot decode phone/RIF from it, only the
  * envelope. Reject packed `||` IDs so a stored compound string is never
- * treated as a QR. Scan & Pay uses the looser `isPagoMovilQr` envelope.
+ * treated as a QR. Same rule for SELL upload and Scan & Pay (`parsePagoMovil`).
+ * `getPayQrPayload` may still re-draw a stored blob without `merchantId`.
  */
 declare function validateVenezuelanQr(payload: string): boolean;
 
@@ -138,7 +158,7 @@ type PeruvianPaymentIdParts = {
     phone: string | null;
     cci: string | null;
 };
-/** QR payload and/or CCI and/or Yape/Plin phone. */
+/** QR payload and/or CCI and/or Yape/Plin phone. A packed rest must be valid typed fields. */
 declare function validatePeruvianPaymentId(value: string): boolean;
 
 /**
@@ -159,7 +179,8 @@ type VenezuelanPaymentIdParts = {
 };
 /**
  * Accepts a Suiche 7B QR payload, the typed `phone|rif|bank` fallback,
- * or both packed as `qr||phone|rif|bank`.
+ * or both packed as `qr||phone|rif|bank`. A non-empty packed rest must be a
+ * valid compound — QR does not mask an incomplete trio.
  */
 declare function validateVenezuelanPaymentId(value: string): boolean;
 
@@ -278,10 +299,21 @@ declare function unpackPackedPaymentId(paymentId: string): {
  * QR blob from a stored payment ID, or `null` if none / invalid.
  */
 declare function getStoredQrPayload(currency: CurrencyCode | null | undefined, paymentId: string | null | undefined): string | null;
+/**
+ * Payload to feed `QRCodeSVG` for a PAY (or packed SELL) order.
+ * Tries strict `getStoredQrPayload` first, then the country's PAY hook.
+ */
+declare function getPayQrPayload(currency: CurrencyCode | null | undefined, paymentId: string | null | undefined): string | null;
 /**
  * Builds a stored payment ID: optional validated QR packed with catalog fields.
  */
 declare function packStoredPaymentId(currency: CurrencyCode, qr: string | null | undefined, fieldValues: Record<string, string>): string;
+/**
+ * Catalog payment form draft: optional QR and/or typed fields may coexist.
+ * Neither path is required relative to the other. If any typed field has text,
+ * non-optional fields must all be present and valid (`optional` on the catalog).
+ */
+declare function validateCatalogPaymentDraft(currency: CurrencyCode, qr: string | null | undefined, fieldValues: Record<string, string>): boolean;
 /**
  * Validates a stored payment ID: optional packed QR, then catalog fields.
  * QR-only is valid when the country exposes `validateQr`.
@@ -298,4 +330,4 @@ declare function assignStoredPaymentIdToFieldValues(currency: CurrencyCode, paym
  */
 declare function formatStoredPaymentIdForDisplay(currency: CurrencyCode, paymentId: string): string;
 
-export { COUNTRY_OPTIONS, CURRENCY, CURRENCY_CODES, type CountryOption, type CurrencyCode, PACKED_PAYMENT_ID_SEP, PAYMENT_ID_FIELDS, type PaymentIdFieldConfig, type PeruvianPaymentIdParts, type VenezuelanPaymentIdParts, assignPaymentIdToFieldValues, assignStoredPaymentIdToFieldValues, deserializeCompoundPaymentId, formatCompoundPaymentIdForDisplay, formatStoredPaymentIdForDisplay, getCountryOption, getStoredQrPayload, packStoredPaymentId, serializeCompoundPaymentId, unpackPackedPaymentId, uploadsPaymentQR, usesCatalogPaymentForm, usesPackedPaymentId, validateArgentinePaymentId, validateBolivianAccount, validateBolivianQr, validateColombianPaymentId, validateCubanCardNumber, validateCubanPhoneNumber, validateEcuadorianAccountName, validateEcuadorianAccountNumber, validateEcuadorianCedula, validateIndonesianPhoneNumber, validateMexicanPaymentId, validateNigerianAccountName, validateNigerianAccountNumber, validatePIXId, validatePaymentIdFields, validatePeruvianCci, validatePeruvianPaymentId, validatePeruvianPaymentKey, validatePeruvianPhone, validatePeruvianQr, validatePhilippinePhoneNumber, validateRevolutId, validateStoredPaymentId, validateUPIId, validateVenezuelanPaymentId, validateVenezuelanPhoneNumber, validateVenezuelanQr, validateVenezuelanRif };
+export { COUNTRY_OPTIONS, CURRENCY, CURRENCY_CODES, type CountryOption, type CurrencyCode, PACKED_PAYMENT_ID_SEP, PAYMENT_ID_FIELDS, type PaymentIdFieldConfig, type PeruvianPaymentIdParts, type VenezuelanPaymentIdParts, assignPaymentIdToFieldValues, assignStoredPaymentIdToFieldValues, deserializeCompoundPaymentId, formatCompoundPaymentIdForDisplay, formatStoredPaymentIdForDisplay, getCountryOption, getPayQrPayload, getStoredQrPayload, getTransferWarning, packStoredPaymentId, serializeCompoundPaymentId, unpackPackedPaymentId, uploadsPaymentQR, usesCatalogPaymentForm, usesPackedPaymentId, validateArgentinePaymentId, validateBolivianAccount, validateBolivianQr, validateCatalogPaymentDraft, validateColombianPaymentId, validateCubanCardNumber, validateCubanPhoneNumber, validateEcuadorianAccountName, validateEcuadorianAccountNumber, validateEcuadorianCedula, validateIndonesianPhoneNumber, validateMexicanPaymentId, validateNigerianAccountName, validateNigerianAccountNumber, validatePIXId, validatePaymentIdFields, validatePeruvianCci, validatePeruvianPaymentId, validatePeruvianPaymentKey, validatePeruvianPhone, validatePeruvianQr, validatePhilippinePhoneNumber, validateRevolutId, validateStoredPaymentId, validateUPIId, validateVenezuelanPaymentId, validateVenezuelanPhoneNumber, validateVenezuelanQr, validateVenezuelanRif };

package/dist/country.d.ts

@@ -72,11 +72,25 @@ interface CountryOption {
     readonly uploadPaymentQR?: boolean;
     /** Structural check for a standalone QR payload (no `||` pack). */
     readonly validateQr?: (payload: string) => boolean;
+    /**
+     * PAY display: payload to re-draw a stored QR. May be looser than
+     * `validateQr` so old orders still render (e.g. Yape/Plin without CRC,
+     * Pago Móvil without `merchantId`). Scan & Pay uses `validateQr` /
+     * parsers, not this hook. Apps call `getPayQrPayload(currency, id)` —
+     * do not branch on currency.
+     */
+    readonly getPayQrPayload?: (paymentId: string) => string | null;
     /**
      * Fill catalog fields from a validated QR (e.g. Yape/Plin phone in EMVCo).
      * Only used when the typed fallback did not already set the key.
      */
     readonly hydrateFieldsFromQr?: (qr: string) => Partial<Record<string, string>>;
+    /**
+     * i18n key for a warning shown before the payer sends fiat (e.g. a bank
+     * outage). Apps call `getTransferWarning(currency)` — do not branch on
+     * currency. Omit when there is no warning.
+     */
+    readonly transferWarning?: string;
 }
 
 /** All supported countries with their currency metadata, payment methods, and display config. */
@@ -93,18 +107,23 @@ declare function uploadsPaymentQR(currency: CurrencyCode | null | undefined): bo
  */
 declare function usesPackedPaymentId(currency: CurrencyCode | null | undefined): boolean;
 /**
- * Apps mount the catalog form (PackedPaymentInput): QR upload and/or
- * more than one typed field.
+ * Apps mount the catalog form (PackedPaymentInput): QR upload and typed
+ * fields may both show — they are not exclusive.
  */
 declare function usesCatalogPaymentForm(currency: CurrencyCode | null | undefined): boolean;
+/**
+ * i18n key for a warning shown before the payer sends fiat, or `null` when the
+ * currency has none. Apps translate with `t(key)` — do not branch on currency.
+ */
+declare function getTransferWarning(currency: CurrencyCode | null | undefined): string | null;
 
 /** Payment ID field configuration for each supported currency. */
 declare const PAYMENT_ID_FIELDS: Record<CurrencyCode, PaymentIdFieldConfig[]>;
 
 /**
  * Yape/Plin EMVCo: country PE, currency 604, CRC-16/CCITT-FALSE.
- * CRC is required on upload so we never persist a truncated screenshot.
- * (PAY render in the merchant is looser; that path does not use this.)
+ * Same rule for SELL upload and Scan & Pay (`parsePeru`).
+ * `getPayQrPayload` may still re-draw a stored blob whose CRC later fails.
  */
 declare function validatePeruvianQr(payload: string): boolean;
 /**
@@ -118,7 +137,8 @@ declare function validateBolivianQr(payload: string): boolean;
  * Suiche 7B / Pago Móvil collection QR: `base64?merchantId=NNNN&…`.
  * The base64 is bank AES — we cannot decode phone/RIF from it, only the
  * envelope. Reject packed `||` IDs so a stored compound string is never
- * treated as a QR. Scan & Pay uses the looser `isPagoMovilQr` envelope.
+ * treated as a QR. Same rule for SELL upload and Scan & Pay (`parsePagoMovil`).
+ * `getPayQrPayload` may still re-draw a stored blob without `merchantId`.
  */
 declare function validateVenezuelanQr(payload: string): boolean;
 
@@ -138,7 +158,7 @@ type PeruvianPaymentIdParts = {
     phone: string | null;
     cci: string | null;
 };
-/** QR payload and/or CCI and/or Yape/Plin phone. */
+/** QR payload and/or CCI and/or Yape/Plin phone. A packed rest must be valid typed fields. */
 declare function validatePeruvianPaymentId(value: string): boolean;
 
 /**
@@ -159,7 +179,8 @@ type VenezuelanPaymentIdParts = {
 };
 /**
  * Accepts a Suiche 7B QR payload, the typed `phone|rif|bank` fallback,
- * or both packed as `qr||phone|rif|bank`.
+ * or both packed as `qr||phone|rif|bank`. A non-empty packed rest must be a
+ * valid compound — QR does not mask an incomplete trio.
  */
 declare function validateVenezuelanPaymentId(value: string): boolean;
 
@@ -278,10 +299,21 @@ declare function unpackPackedPaymentId(paymentId: string): {
  * QR blob from a stored payment ID, or `null` if none / invalid.
  */
 declare function getStoredQrPayload(currency: CurrencyCode | null | undefined, paymentId: string | null | undefined): string | null;
+/**
+ * Payload to feed `QRCodeSVG` for a PAY (or packed SELL) order.
+ * Tries strict `getStoredQrPayload` first, then the country's PAY hook.
+ */
+declare function getPayQrPayload(currency: CurrencyCode | null | undefined, paymentId: string | null | undefined): string | null;
 /**
  * Builds a stored payment ID: optional validated QR packed with catalog fields.
  */
 declare function packStoredPaymentId(currency: CurrencyCode, qr: string | null | undefined, fieldValues: Record<string, string>): string;
+/**
+ * Catalog payment form draft: optional QR and/or typed fields may coexist.
+ * Neither path is required relative to the other. If any typed field has text,
+ * non-optional fields must all be present and valid (`optional` on the catalog).
+ */
+declare function validateCatalogPaymentDraft(currency: CurrencyCode, qr: string | null | undefined, fieldValues: Record<string, string>): boolean;
 /**
  * Validates a stored payment ID: optional packed QR, then catalog fields.
  * QR-only is valid when the country exposes `validateQr`.
@@ -298,4 +330,4 @@ declare function assignStoredPaymentIdToFieldValues(currency: CurrencyCode, paym
  */
 declare function formatStoredPaymentIdForDisplay(currency: CurrencyCode, paymentId: string): string;
 
-export { COUNTRY_OPTIONS, CURRENCY, CURRENCY_CODES, type CountryOption, type CurrencyCode, PACKED_PAYMENT_ID_SEP, PAYMENT_ID_FIELDS, type PaymentIdFieldConfig, type PeruvianPaymentIdParts, type VenezuelanPaymentIdParts, assignPaymentIdToFieldValues, assignStoredPaymentIdToFieldValues, deserializeCompoundPaymentId, formatCompoundPaymentIdForDisplay, formatStoredPaymentIdForDisplay, getCountryOption, getStoredQrPayload, packStoredPaymentId, serializeCompoundPaymentId, unpackPackedPaymentId, uploadsPaymentQR, usesCatalogPaymentForm, usesPackedPaymentId, validateArgentinePaymentId, validateBolivianAccount, validateBolivianQr, validateColombianPaymentId, validateCubanCardNumber, validateCubanPhoneNumber, validateEcuadorianAccountName, validateEcuadorianAccountNumber, validateEcuadorianCedula, validateIndonesianPhoneNumber, validateMexicanPaymentId, validateNigerianAccountName, validateNigerianAccountNumber, validatePIXId, validatePaymentIdFields, validatePeruvianCci, validatePeruvianPaymentId, validatePeruvianPaymentKey, validatePeruvianPhone, validatePeruvianQr, validatePhilippinePhoneNumber, validateRevolutId, validateStoredPaymentId, validateUPIId, validateVenezuelanPaymentId, validateVenezuelanPhoneNumber, validateVenezuelanQr, validateVenezuelanRif };
+export { COUNTRY_OPTIONS, CURRENCY, CURRENCY_CODES, type CountryOption, type CurrencyCode, PACKED_PAYMENT_ID_SEP, PAYMENT_ID_FIELDS, type PaymentIdFieldConfig, type PeruvianPaymentIdParts, type VenezuelanPaymentIdParts, assignPaymentIdToFieldValues, assignStoredPaymentIdToFieldValues, deserializeCompoundPaymentId, formatCompoundPaymentIdForDisplay, formatStoredPaymentIdForDisplay, getCountryOption, getPayQrPayload, getStoredQrPayload, getTransferWarning, packStoredPaymentId, serializeCompoundPaymentId, unpackPackedPaymentId, uploadsPaymentQR, usesCatalogPaymentForm, usesPackedPaymentId, validateArgentinePaymentId, validateBolivianAccount, validateBolivianQr, validateCatalogPaymentDraft, validateColombianPaymentId, validateCubanCardNumber, validateCubanPhoneNumber, validateEcuadorianAccountName, validateEcuadorianAccountNumber, validateEcuadorianCedula, validateIndonesianPhoneNumber, validateMexicanPaymentId, validateNigerianAccountName, validateNigerianAccountNumber, validatePIXId, validatePaymentIdFields, validatePeruvianCci, validatePeruvianPaymentId, validatePeruvianPaymentKey, validatePeruvianPhone, validatePeruvianQr, validatePhilippinePhoneNumber, validateRevolutId, validateStoredPaymentId, validateUPIId, validateVenezuelanPaymentId, validateVenezuelanPhoneNumber, validateVenezuelanQr, validateVenezuelanRif };

package/dist/country.mjs

@@ -148,6 +148,39 @@ function validateVenezuelanQr(payload) {
   if (!/^[A-Za-z0-9+/=]+$/.test(blob)) return false;
   return /(?:^|[?&])merchantId=\d{3,4}(?:&|$)/.test(trimmed.substring(qIdx));
 }
+function payQrCandidate(paymentId) {
+  const trimmed = paymentId.trim();
+  const sep = trimmed.indexOf(PACKED_PAYMENT_ID_SEP);
+  return (sep >= 0 ? trimmed.slice(0, sep) : trimmed).trim();
+}
+function isPeruvianPayQr(payload) {
+  if (!payload.startsWith("0002")) return false;
+  return payload.includes("5802PE") && payload.includes("5303604");
+}
+function isVenezuelanPayQr(payload) {
+  if (!payload || payload.includes(PACKED_PAYMENT_ID_SEP)) return false;
+  const qIdx = payload.indexOf("?");
+  if (qIdx === -1) return false;
+  const blob = payload.slice(0, qIdx);
+  return blob.length > 0 && /^[A-Za-z0-9+/=]+$/.test(blob);
+}
+function isPhilippinePayQr(payload) {
+  if (!payload.startsWith("0002")) return false;
+  return payload.includes("5802PH") && payload.includes("5303608");
+}
+function isBolivianPayQr(payload) {
+  if (!payload || payload.includes(PACKED_PAYMENT_ID_SEP)) return false;
+  if (payload.startsWith("0002") && payload.includes("5802BO") && payload.includes("5303068")) {
+    return true;
+  }
+  const sep = payload.lastIndexOf("|");
+  if (sep < 40) return false;
+  const blob = payload.slice(0, sep);
+  const tag = payload.slice(sep + 1);
+  if (blob.length % 4 !== 0) return false;
+  if (!/^[A-Za-z0-9+/]+={0,2}$/.test(blob)) return false;
+  return /^[0-9A-Fa-f]{16,64}$/.test(tag);
+}
 
 // src/country/currencies/bob.ts
 var BOB_PLACEHOLDER = "Bank account number (8\u201320 digits)";
@@ -180,7 +213,7 @@ var BOB_COUNTRY_OPTION = {
   flag: "\u{1F1E7}\u{1F1F4}",
   flagUrl: "https://cdn.jsdelivr.net/gh/twitter/twemoji@14.0.2/assets/72x72/1f1e7-1f1f4.png",
   phoneCode: "+591",
-  telegramSupportChannel: "https://t.me/p2pmebolivia",
+  telegramSupportChannel: "https://t.me/p2pme_bolivia_merchants",
   twitterUsername: "p2pmebolivia",
   smsCountryCodes: ["BO"],
   precision: 2,
@@ -188,7 +221,11 @@ var BOB_COUNTRY_OPTION = {
   disabled: false,
   disabledPaymentTypes: [],
   uploadPaymentQR: true,
-  validateQr: validateBolivianQr
+  validateQr: validateBolivianQr,
+  getPayQrPayload: (paymentId) => {
+    const candidate = payQrCandidate(paymentId);
+    return isBolivianPayQr(candidate) ? candidate : null;
+  }
 };
 
 // src/country/currencies/brl.ts
@@ -371,7 +408,8 @@ var CUP_COUNTRY_OPTION = {
   precision: 2,
   isAlpha: true,
   disabled: false,
-  disabledPaymentTypes: []
+  disabledPaymentTypes: [],
+  transferWarning: "CUP_BANDEC_WARNING"
 };
 
 // src/country/currencies/ecu.ts
@@ -768,54 +806,24 @@ function extractPeruvianPhoneFromQr(payload) {
   }
   return null;
 }
-function parsePeruvianFallback(value) {
-  const trimmed = value.trim();
-  if (!trimmed) return { phone: null, cci: null };
-  const tokens = trimmed.split("|").map((token) => token.trim()).filter(Boolean);
-  let phone = null;
-  let cci = null;
-  for (const token of tokens) {
-    if (!phone && validatePeruvianPhone(token)) {
-      phone = normalizePeruvianPaymentKey(token);
-      continue;
-    }
-    if (!cci && validatePeruvianCci(token)) {
-      cci = normalizePeruvianPaymentKey(token);
-    }
-  }
-  return { phone, cci };
+function isValidPeruvianTypedRest(value) {
+  const nonempty = value.split("|").map((token) => token.trim()).filter((token) => token.length > 0);
+  if (nonempty.length === 0) return false;
+  return nonempty.every((token) => validatePeruvianPhone(token) || validatePeruvianCci(token));
 }
-function parsePeruvianPaymentId(value) {
-  if (!value || typeof value !== "string") {
-    return { qr: null, phone: null, cci: null };
-  }
+function validatePeruvianPaymentId(value) {
+  if (!value || typeof value !== "string") return false;
   const trimmed = value.trim();
   const sep = trimmed.indexOf(PACKED_PAYMENT_ID_SEP);
   if (sep >= 0) {
     const left = trimmed.slice(0, sep);
     const right = trimmed.slice(sep + PACKED_PAYMENT_ID_SEP.length);
-    const fallback2 = parsePeruvianFallback(right);
-    const qr = validatePeruvianQr(left) ? left : null;
-    return {
-      qr,
-      phone: fallback2.phone ?? (qr ? extractPeruvianPhoneFromQr(qr) : null),
-      cci: fallback2.cci
-    };
-  }
-  if (validatePeruvianQr(trimmed)) {
-    return {
-      qr: trimmed,
-      phone: extractPeruvianPhoneFromQr(trimmed),
-      cci: null
-    };
+    const qrOk = validatePeruvianQr(left);
+    if (right.trim()) return qrOk && isValidPeruvianTypedRest(right);
+    return qrOk;
   }
-  const fallback = parsePeruvianFallback(trimmed);
-  return { qr: null, phone: fallback.phone, cci: fallback.cci };
-}
-function validatePeruvianPaymentId(value) {
-  if (!value || typeof value !== "string") return false;
-  const { qr, phone, cci } = parsePeruvianPaymentId(value);
-  return Boolean(qr || phone || cci);
+  if (validatePeruvianQr(trimmed)) return true;
+  return isValidPeruvianTypedRest(trimmed);
 }
 var PEN_PAYMENT_FIELDS = [
   {
@@ -858,6 +866,10 @@ var PEN_COUNTRY_OPTION = {
   disabledPaymentTypes: [],
   uploadPaymentQR: true,
   validateQr: validatePeruvianQr,
+  getPayQrPayload: (paymentId) => {
+    const candidate = payQrCandidate(paymentId);
+    return isPeruvianPayQr(candidate) ? candidate : null;
+  },
   hydrateFieldsFromQr: (qr) => {
     const phone = extractPeruvianPhoneFromQr(qr);
     return phone ? { phone } : {};
@@ -914,7 +926,11 @@ var PHP_COUNTRY_OPTION = {
   precision: 2,
   isAlpha: true,
   disabled: false,
-  disabledPaymentTypes: []
+  disabledPaymentTypes: [],
+  getPayQrPayload: (paymentId) => {
+    const candidate = payQrCandidate(paymentId);
+    return isPhilippinePayQr(candidate) ? candidate : null;
+  }
 };
 
 // src/country/currencies/usd.ts
@@ -993,7 +1009,16 @@ function parseVenezuelanPaymentId(value) {
 }
 function validateVenezuelanPaymentId(value) {
   if (!value || typeof value !== "string") return false;
-  const { qr, compound } = parseVenezuelanPaymentId(value);
+  const trimmed = value.trim();
+  const sep = trimmed.indexOf(PACKED_PAYMENT_ID_SEP);
+  if (sep >= 0) {
+    const left = trimmed.slice(0, sep);
+    const right = trimmed.slice(sep + PACKED_PAYMENT_ID_SEP.length);
+    const qrOk = validateVenezuelanQr(left);
+    if (right.trim()) return qrOk && isValidVenezuelanCompound(right);
+    return qrOk;
+  }
+  const { qr, compound } = parseVenezuelanPaymentId(trimmed);
   return qr !== null || compound !== null;
 }
 var VEN_PAYMENT_FIELDS = [
@@ -1043,7 +1068,11 @@ var VEN_COUNTRY_OPTION = {
   disabled: false,
   disabledPaymentTypes: [],
   uploadPaymentQR: true,
-  validateQr: validateVenezuelanQr
+  validateQr: validateVenezuelanQr,
+  getPayQrPayload: (paymentId) => {
+    const candidate = payQrCandidate(paymentId);
+    return isVenezuelanPayQr(candidate) ? candidate : null;
+  }
 };
 
 // src/country/payment-fields.ts
@@ -1097,6 +1126,9 @@ function usesCatalogPaymentForm(currency) {
   if (!currency) return false;
   return uploadsPaymentQR(currency) || (PAYMENT_ID_FIELDS[currency]?.length ?? 0) > 1;
 }
+function getTransferWarning(currency) {
+  return getCountryOption(currency)?.transferWarning ?? null;
+}
 
 // src/country/validators.ts
 function serializeCompoundPaymentId(...fields) {
@@ -1179,12 +1211,14 @@ function getStoredQrPayload(currency, paymentId) {
   if (isStandaloneQr(option.validateQr, trimmed)) return trimmed;
   return null;
 }
+function getPayQrPayload(currency, paymentId) {
+  if (!currency || !paymentId) return null;
+  const stored = getStoredQrPayload(currency, paymentId);
+  if (stored) return stored;
+  return getCountryOption(currency)?.getPayQrPayload?.(paymentId.trim()) ?? null;
+}
 function packedTypedRest(fields, fieldValues) {
-  const parts = fields.map((field) => {
-    const value = (fieldValues[field.key] ?? "").trim();
-    if (!value) return "";
-    return field.validate(value) ? value : "";
-  });
+  const parts = fields.map((field) => (fieldValues[field.key] ?? "").trim());
   if (!parts.some((part) => part.length > 0)) return "";
   return serializeCompoundPaymentId(...parts);
 }
@@ -1200,11 +1234,16 @@ function packStoredPaymentId(currency, qr, fieldValues) {
 function fieldsMatchStoredId(fields, paymentId) {
   if (validatePaymentIdFields(fields, paymentId)) return true;
   const assigned = assignPaymentIdToFieldValues(fields, paymentId);
-  const filled = fields.filter((field) => (assigned[field.key] || "").trim().length > 0);
-  if (filled.length === 0) return false;
-  return fields.every(
-    (field) => field.optional === true || (assigned[field.key] || "").trim().length > 0
-  );
+  const values = fields.map((field) => (assigned[field.key] || "").trim());
+  if (!values.some((value) => value.length > 0)) return false;
+  return fields.every((field, i) => {
+    const value = values[i];
+    if (!value) return field.optional === true;
+    return field.validate(value);
+  });
+}
+function validateCatalogPaymentDraft(currency, qr, fieldValues) {
+  return validateStoredPaymentId(currency, packStoredPaymentId(currency, qr, fieldValues));
 }
 function validateStoredPaymentId(currency, paymentId) {
   if (!paymentId || paymentId.trim().length === 0) return false;
@@ -1233,6 +1272,12 @@ function assignStoredPaymentIdToFieldValues(currency, paymentId) {
   } else if (isStandaloneQr(option?.validateQr, trimmed)) {
     qrPayload = trimmed;
     typed = "";
+  } else {
+    const payQr = option?.getPayQrPayload?.(trimmed);
+    if (payQr) {
+      qrPayload = payQr;
+      typed = qr && payQr === qr ? rest.trim() : "";
+    }
   }
   const values = assignPaymentIdToFieldValues(fields, typed);
   if (qrPayload && option?.hydrateFieldsFromQr) {
@@ -1265,7 +1310,9 @@ export {
   formatCompoundPaymentIdForDisplay,
   formatStoredPaymentIdForDisplay,
   getCountryOption,
+  getPayQrPayload,
   getStoredQrPayload,
+  getTransferWarning,
   packStoredPaymentId,
   serializeCompoundPaymentId,
   unpackPackedPaymentId,
@@ -1275,6 +1322,7 @@ export {
   validateArgentinePaymentId,
   validateBolivianAccount,
   validateBolivianQr,
+  validateCatalogPaymentDraft,
   validateColombianPaymentId,
   validateCubanCardNumber,
   validateCubanPhoneNumber,