@vexpay/node 0.6.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -155,7 +155,7 @@ interface components {
155
155
  * "payment.failed"
156
156
  * ]
157
157
  */
158
- events: ("payment.pending" | "payment.completed" | "payment.failed" | "payment.canceled" | "payment.reversed" | "payment.chargeback" | "payment.chargeback_closed" | "merchant.verified" | "merchant.rejected" | "merchant.deactivated" | "merchant.reactivated" | "merchant.balance.updated" | "merchant.created" | "merchant.activated" | "merchant.updated" | "merchant.kyb_required" | "merchant.restricted" | "merchant.capability.updated" | "merchant.wallet_credit" | "payout.completed" | "payout.failed" | "conversion.completed" | "conversion.canceled" | "tenant.status_changed" | "tenant.api_key.created" | "tenant.api_key.rotated" | "tenant.api_key.revoked" | "tenant.live_status_changed" | "notification.test")[];
158
+ events: ("payment.pending" | "payment.completed" | "payment.failed" | "payment.canceled" | "payment.reversed" | "payment.chargeback" | "payment.chargeback_closed" | "merchant.verified" | "merchant.rejected" | "merchant.deactivated" | "merchant.reactivated" | "merchant.balance.updated" | "merchant.created" | "merchant.activated" | "merchant.updated" | "merchant.kyb_required" | "merchant.restricted" | "merchant.capability.updated" | "merchant.wallet_credit" | "payout.completed" | "payout.failed" | "conversion.created" | "conversion.completed" | "conversion.canceled" | "tenant.status_changed" | "tenant.api_key.created" | "tenant.api_key.rotated" | "tenant.api_key.revoked" | "tenant.live_status_changed" | "notification.test")[];
159
159
  };
160
160
  WebhookEndpointDto: {
161
161
  /** Format: uuid */
@@ -164,7 +164,7 @@ interface components {
164
164
  tenantId: string;
165
165
  /** Format: uri */
166
166
  url: string;
167
- events: ("payment.pending" | "payment.completed" | "payment.failed" | "payment.canceled" | "payment.reversed" | "payment.chargeback" | "payment.chargeback_closed" | "merchant.verified" | "merchant.rejected" | "merchant.deactivated" | "merchant.reactivated" | "merchant.balance.updated" | "merchant.created" | "merchant.activated" | "merchant.updated" | "merchant.kyb_required" | "merchant.restricted" | "merchant.capability.updated" | "merchant.wallet_credit" | "payout.completed" | "payout.failed" | "conversion.completed" | "conversion.canceled" | "tenant.status_changed" | "tenant.api_key.created" | "tenant.api_key.rotated" | "tenant.api_key.revoked" | "tenant.live_status_changed" | "notification.test")[];
167
+ events: ("payment.pending" | "payment.completed" | "payment.failed" | "payment.canceled" | "payment.reversed" | "payment.chargeback" | "payment.chargeback_closed" | "merchant.verified" | "merchant.rejected" | "merchant.deactivated" | "merchant.reactivated" | "merchant.balance.updated" | "merchant.created" | "merchant.activated" | "merchant.updated" | "merchant.kyb_required" | "merchant.restricted" | "merchant.capability.updated" | "merchant.wallet_credit" | "payout.completed" | "payout.failed" | "conversion.created" | "conversion.completed" | "conversion.canceled" | "tenant.status_changed" | "tenant.api_key.created" | "tenant.api_key.rotated" | "tenant.api_key.revoked" | "tenant.live_status_changed" | "notification.test")[];
168
168
  isActive: boolean;
169
169
  /** Format: date-time */
170
170
  createdAt: string;
@@ -185,7 +185,7 @@ interface components {
185
185
  * "payout.completed"
186
186
  * ]
187
187
  */
188
- events?: ("payment.pending" | "payment.completed" | "payment.failed" | "payment.canceled" | "payment.reversed" | "payment.chargeback" | "payment.chargeback_closed" | "merchant.verified" | "merchant.rejected" | "merchant.deactivated" | "merchant.reactivated" | "merchant.balance.updated" | "merchant.created" | "merchant.activated" | "merchant.updated" | "merchant.kyb_required" | "merchant.restricted" | "merchant.capability.updated" | "merchant.wallet_credit" | "payout.completed" | "payout.failed" | "conversion.completed" | "conversion.canceled" | "tenant.status_changed" | "tenant.api_key.created" | "tenant.api_key.rotated" | "tenant.api_key.revoked" | "tenant.live_status_changed" | "notification.test")[];
188
+ events?: ("payment.pending" | "payment.completed" | "payment.failed" | "payment.canceled" | "payment.reversed" | "payment.chargeback" | "payment.chargeback_closed" | "merchant.verified" | "merchant.rejected" | "merchant.deactivated" | "merchant.reactivated" | "merchant.balance.updated" | "merchant.created" | "merchant.activated" | "merchant.updated" | "merchant.kyb_required" | "merchant.restricted" | "merchant.capability.updated" | "merchant.wallet_credit" | "payout.completed" | "payout.failed" | "conversion.created" | "conversion.completed" | "conversion.canceled" | "tenant.status_changed" | "tenant.api_key.created" | "tenant.api_key.rotated" | "tenant.api_key.revoked" | "tenant.live_status_changed" | "notification.test")[];
189
189
  /** @example true */
190
190
  isActive?: boolean;
191
191
  };
@@ -1277,14 +1277,84 @@ interface components {
1277
1277
  /** Format: date-time */
1278
1278
  asOf: string;
1279
1279
  };
1280
+ CurrencyFlagsDto: {
1281
+ VES: boolean;
1282
+ COP: boolean;
1283
+ };
1284
+ CurrencyAmountsDto: {
1285
+ /** @example 3.0000 */
1286
+ VES: string;
1287
+ /** @example 3.0000 */
1288
+ COP: string;
1289
+ };
1290
+ CurrencyCapsDto: {
1291
+ /**
1292
+ * @description Max VES per Caracas day; `null` = no cap.
1293
+ * @example null
1294
+ */
1295
+ VES: string | null;
1296
+ /**
1297
+ * @description Max COP per Bogotá day; `null` = no cap.
1298
+ * @example 2000000
1299
+ */
1300
+ COP: string | null;
1301
+ };
1302
+ AutoConvertPercentDto: {
1303
+ /**
1304
+ * @description Whole number; 0 = off.
1305
+ * @example 50
1306
+ */
1307
+ percent: number;
1308
+ };
1309
+ AutoConvertDto: {
1310
+ COP: components["schemas"]["AutoConvertPercentDto"];
1311
+ };
1312
+ ConversionSettingsDto: {
1313
+ /** @example conversion_settings */
1314
+ object: string;
1315
+ /** @description Conversions are enabled for your account. */
1316
+ enabled: boolean;
1317
+ /** @description Which currencies you can convert from right now. */
1318
+ sourceCurrencies: components["schemas"]["CurrencyFlagsDto"];
1319
+ /** @description Your spread per source currency, in percent. */
1320
+ spreadPercent: components["schemas"]["CurrencyAmountsDto"];
1321
+ /**
1322
+ * @description Smallest USDT amount a conversion may deliver.
1323
+ * @example 10.00
1324
+ */
1325
+ minimumUsdt: string;
1326
+ dailyMax: components["schemas"]["CurrencyCapsDto"];
1327
+ autoConvert: components["schemas"]["AutoConvertDto"];
1328
+ };
1329
+ UpdateConversionSettingsDto: {
1330
+ /**
1331
+ * @example {
1332
+ * "COP": {
1333
+ * "percent": 50
1334
+ * }
1335
+ * }
1336
+ */
1337
+ autoConvert: components["schemas"]["AutoConvertDto"];
1338
+ };
1280
1339
  CreateConversionQuoteDto: {
1281
1340
  /**
1282
- * @description VES to spend. Send this or `targetAmountUsdt`, not both.
1341
+ * @description Currency you convert from. Defaults to `VES`.
1342
+ * @default VES
1343
+ * @enum {string}
1344
+ */
1345
+ sourceCurrency?: "VES" | "COP";
1346
+ /**
1347
+ * @description Amount of `sourceCurrency` to spend (VES: up to 2 decimals; COP: whole pesos). Send this or `targetAmountUsdt`, not both.
1348
+ * @example 1000000
1349
+ */
1350
+ sourceAmount?: string;
1351
+ /**
1352
+ * @description VES only: same as `sourceAmount` (kept for existing integrations).
1283
1353
  * @example 10000.00
1284
1354
  */
1285
1355
  sourceAmountVes?: string;
1286
1356
  /**
1287
- * @description USDT to receive. Send this or `sourceAmountVes`, not both.
1357
+ * @description USDT to receive. Send this or `sourceAmount`, not both.
1288
1358
  * @example 50.00
1289
1359
  */
1290
1360
  targetAmountUsdt?: string;
@@ -1294,12 +1364,12 @@ interface components {
1294
1364
  /** @example conversion_quote */
1295
1365
  object: string;
1296
1366
  /**
1297
- * @description VES per 1 USDT you get: market rate plus your spread.
1367
+ * @description Units of `sourceCurrency` per 1 USDT you get: market rate plus your spread.
1298
1368
  * @example 998.8299
1299
1369
  */
1300
1370
  rate: string;
1301
1371
  /**
1302
- * @description Market USDT/VES rate the quote is based on.
1372
+ * @description Market USDT rate (in `sourceCurrency`) the quote is based on.
1303
1373
  * @example 979.2450
1304
1374
  */
1305
1375
  marketRate: string;
@@ -1313,8 +1383,18 @@ interface components {
1313
1383
  * @enum {string}
1314
1384
  */
1315
1385
  rateSource: "market";
1316
- /** @example 10000.00 */
1317
- sourceAmountVes: string;
1386
+ /** @enum {string} */
1387
+ sourceCurrency: "VES" | "COP";
1388
+ /**
1389
+ * @description Amount debited (VES to the cent, COP in whole pesos; rounded up).
1390
+ * @example 10000.00
1391
+ */
1392
+ sourceAmount: string;
1393
+ /**
1394
+ * @description VES quotes only; `null` for COP.
1395
+ * @example 10000.00
1396
+ */
1397
+ sourceAmountVes: string | null;
1318
1398
  /**
1319
1399
  * @description Rounded down to the cent.
1320
1400
  * @example 10.01
@@ -1351,10 +1431,27 @@ interface components {
1351
1431
  * @enum {string}
1352
1432
  */
1353
1433
  rateSource: "market";
1354
- /** @example 10000.00 */
1355
- sourceAmountVes: string;
1434
+ /** @enum {string} */
1435
+ sourceCurrency: "VES" | "COP";
1436
+ /**
1437
+ * @description Amount debited (VES to the cent, COP in whole pesos).
1438
+ * @example 10000.00
1439
+ */
1440
+ sourceAmount: string;
1441
+ /**
1442
+ * @description VES conversions only; `null` for COP.
1443
+ * @example 10000.00
1444
+ */
1445
+ sourceAmountVes: string | null;
1356
1446
  /** @example 10.01 */
1357
1447
  targetAmountUsdt: string;
1448
+ /**
1449
+ * @description `auto` when created by auto-convert from a pay-in.
1450
+ * @enum {string}
1451
+ */
1452
+ origin: "api" | "auto";
1453
+ /** @description The pay-in an auto-conversion came from; `null` otherwise. */
1454
+ paymentId: string | null;
1358
1455
  createdAt: string;
1359
1456
  completedAt: string | null;
1360
1457
  canceledAt: string | null;
@@ -1423,8 +1520,16 @@ interface components {
1423
1520
  };
1424
1521
  };
1425
1522
  C2pRequestDto: {
1426
- /** @example 25 */
1427
- usdAmount: number;
1523
+ /**
1524
+ * @description USD amount. Required unless vesAmount is set. When only usdAmount is set, VES is derived at the live BCV rate.
1525
+ * @example 25
1526
+ */
1527
+ usdAmount?: number;
1528
+ /**
1529
+ * @description VES amount debited at the bank. When set, locks the bolívar charge and derives USD at BCV (it wins over usdAmount). The intent keeps this amount until it is executed.
1530
+ * @example 50
1531
+ */
1532
+ vesAmount?: number;
1428
1533
  /** @example V12345678 */
1429
1534
  debtorId: string;
1430
1535
  /**
@@ -1542,8 +1647,16 @@ interface components {
1542
1647
  * @description Pending intent returned by POST /v1/payments/c2p/request.
1543
1648
  */
1544
1649
  intentId?: string;
1545
- /** @example 25 */
1546
- usdAmount: number;
1650
+ /**
1651
+ * @description USD amount. Required unless vesAmount or intentId is set. When only usdAmount is set, VES is derived at the live BCV rate.
1652
+ * @example 25
1653
+ */
1654
+ usdAmount?: number;
1655
+ /**
1656
+ * @description VES amount debited at the bank. When set, locks the bolívar charge and derives USD at BCV (it wins over usdAmount). With intentId the amount locked on the intent is charged; amounts sent here must match it (±0.01 Bs / ±$0.01).
1657
+ * @example 50
1658
+ */
1659
+ vesAmount?: number;
1547
1660
  /** @example V12345678 */
1548
1661
  debtorId: string;
1549
1662
  /** @example 584121234567 */
@@ -1714,6 +1827,25 @@ interface components {
1714
1827
  */
1715
1828
  applicationFeePercent?: number;
1716
1829
  };
1830
+ PaymentMethodAvailabilityDto: {
1831
+ /**
1832
+ * @description `pago_movil`: the customer sends a Pago Móvil (verify). `c2p`: bank debit with the customer's OTP. `vpos`: card.
1833
+ * @enum {string}
1834
+ */
1835
+ method: "pago_movil" | "c2p" | "vpos";
1836
+ /** @description Whether your account can take this method right now. */
1837
+ available: boolean;
1838
+ /**
1839
+ * @description Only when available is false. `not_enabled`: the method is not enabled on your account. `receiving_account_not_configured`: Pago Móvil receiving details are not set up yet. `provider_not_configured`: temporarily unavailable in this mode — contact support.
1840
+ * @enum {string}
1841
+ */
1842
+ reason?: "not_enabled" | "receiving_account_not_configured" | "provider_not_configured";
1843
+ };
1844
+ PaymentMethodsResponseDto: {
1845
+ /** @description false for test keys. */
1846
+ livemode: boolean;
1847
+ methods: components["schemas"]["PaymentMethodAvailabilityDto"][];
1848
+ };
1717
1849
  PagoMovilReceivingAccountDto: {
1718
1850
  /**
1719
1851
  * @description Provider Pago Móvil verify uses for this tenant (same routing as POST /v1/payments/pago-movil/verify).
@@ -2039,8 +2171,8 @@ interface components {
2039
2171
  * ]
2040
2172
  */
2041
2173
  allowedOrigins?: string[];
2042
- /** @description Payment methods offered. Defaults to every method your account can accept. `cop` (Colombian pesos: Bre-B, Nequi, Daviplata) needs the COP method on your account. */
2043
- methods?: ("c2p" | "vpos" | "usdt" | "usdc" | "cop")[];
2174
+ /** @description Payment methods offered. Defaults to every method your account can accept. `c2p` is the bank pull shown as Débito Inmediato; `pago_movil` is a Pago Móvil the buyer sends from their bank app (needs Pago Móvil enabled on your account). `cop` (Colombian pesos: Bre-B, Nequi, Daviplata) needs the COP method on your account. */
2175
+ methods?: ("c2p" | "pago_movil" | "vpos" | "usdt" | "usdc" | "cop")[];
2044
2176
  /**
2045
2177
  * @description Up to 20 string key/value pairs (keys ≤ 40 chars, values ≤ 500 chars).
2046
2178
  * @example {
@@ -2076,7 +2208,7 @@ interface components {
2076
2208
  [key: string]: string;
2077
2209
  };
2078
2210
  allowedOrigins: string[];
2079
- methods: ("c2p" | "vpos" | "usdt" | "usdc" | "cop")[];
2211
+ methods: ("c2p" | "pago_movil" | "vpos" | "usdt" | "usdc" | "cop")[];
2080
2212
  successUrl?: string | null;
2081
2213
  cancelUrl?: string | null;
2082
2214
  /** @description Latest payment for this session, once one exists. */
@@ -5158,6 +5290,129 @@ interface operations {
5158
5290
  };
5159
5291
  };
5160
5292
  };
5293
+ ConversionSettings_get: {
5294
+ parameters: {
5295
+ query?: never;
5296
+ header?: never;
5297
+ path?: never;
5298
+ cookie?: never;
5299
+ };
5300
+ requestBody?: never;
5301
+ responses: {
5302
+ 200: {
5303
+ headers: {
5304
+ [name: string]: unknown;
5305
+ };
5306
+ content: {
5307
+ "application/json": components["schemas"]["ConversionSettingsDto"];
5308
+ };
5309
+ };
5310
+ /** @description Missing, invalid, or inactive tenant API key. */
5311
+ 401: {
5312
+ headers: {
5313
+ [name: string]: unknown;
5314
+ };
5315
+ content: {
5316
+ "application/json": components["schemas"]["ApiErrorDto"];
5317
+ };
5318
+ };
5319
+ /** @description Live mode not activated (`live_mode_not_activated`): the live account is pending VEX Pay review or suspended. Test keys are unaffected. */
5320
+ 403: {
5321
+ headers: {
5322
+ [name: string]: unknown;
5323
+ };
5324
+ content: {
5325
+ "application/json": components["schemas"]["ApiErrorDto"];
5326
+ };
5327
+ };
5328
+ /** @description Client error. */
5329
+ "4XX": {
5330
+ headers: {
5331
+ [name: string]: unknown;
5332
+ };
5333
+ content: {
5334
+ "application/json": components["schemas"]["ApiErrorDto"];
5335
+ };
5336
+ };
5337
+ /** @description Server or upstream bank error. */
5338
+ "5XX": {
5339
+ headers: {
5340
+ [name: string]: unknown;
5341
+ };
5342
+ content: {
5343
+ "application/json": components["schemas"]["ApiErrorDto"];
5344
+ };
5345
+ };
5346
+ };
5347
+ };
5348
+ ConversionSettings_update: {
5349
+ parameters: {
5350
+ query?: never;
5351
+ header?: never;
5352
+ path?: never;
5353
+ cookie?: never;
5354
+ };
5355
+ requestBody: {
5356
+ content: {
5357
+ "application/json": components["schemas"]["UpdateConversionSettingsDto"];
5358
+ };
5359
+ };
5360
+ responses: {
5361
+ 200: {
5362
+ headers: {
5363
+ [name: string]: unknown;
5364
+ };
5365
+ content: {
5366
+ "application/json": components["schemas"]["ConversionSettingsDto"];
5367
+ };
5368
+ };
5369
+ /** @description `invalid_data` — unknown field or percent outside 0–100. */
5370
+ 400: {
5371
+ headers: {
5372
+ [name: string]: unknown;
5373
+ };
5374
+ content: {
5375
+ "application/json": components["schemas"]["ApiErrorDto"];
5376
+ };
5377
+ };
5378
+ /** @description Missing, invalid, or inactive tenant API key. */
5379
+ 401: {
5380
+ headers: {
5381
+ [name: string]: unknown;
5382
+ };
5383
+ content: {
5384
+ "application/json": components["schemas"]["ApiErrorDto"];
5385
+ };
5386
+ };
5387
+ /** @description `conversions_not_enabled` — COP conversions are not allowed for this account. */
5388
+ 403: {
5389
+ headers: {
5390
+ [name: string]: unknown;
5391
+ };
5392
+ content: {
5393
+ "application/json": components["schemas"]["ApiErrorDto"];
5394
+ };
5395
+ };
5396
+ /** @description Client error. */
5397
+ "4XX": {
5398
+ headers: {
5399
+ [name: string]: unknown;
5400
+ };
5401
+ content: {
5402
+ "application/json": components["schemas"]["ApiErrorDto"];
5403
+ };
5404
+ };
5405
+ /** @description Server or upstream bank error. */
5406
+ "5XX": {
5407
+ headers: {
5408
+ [name: string]: unknown;
5409
+ };
5410
+ content: {
5411
+ "application/json": components["schemas"]["ApiErrorDto"];
5412
+ };
5413
+ };
5414
+ };
5415
+ };
5161
5416
  Conversions_createQuote: {
5162
5417
  parameters: {
5163
5418
  query?: never;
@@ -5253,6 +5508,7 @@ interface operations {
5253
5508
  status?: "PENDING" | "COMPLETED" | "CANCELED";
5254
5509
  cursor?: string;
5255
5510
  limit?: string;
5511
+ sourceCurrency?: "VES" | "COP";
5256
5512
  };
5257
5513
  header?: never;
5258
5514
  path?: never;
@@ -5863,7 +6119,7 @@ interface operations {
5863
6119
  "application/json": components["schemas"]["PaymentReceiptDto"];
5864
6120
  };
5865
6121
  };
5866
- /** @description Invalid request or unsupported operation. */
6122
+ /** @description Invalid body, or a VPOS test card sent with a Live key (test_card_in_live_mode). */
5867
6123
  400: {
5868
6124
  headers: {
5869
6125
  [name: string]: unknown;
@@ -5928,6 +6184,70 @@ interface operations {
5928
6184
  };
5929
6185
  };
5930
6186
  };
6187
+ Payments_listPaymentMethods: {
6188
+ parameters: {
6189
+ query?: never;
6190
+ header?: never;
6191
+ path?: never;
6192
+ cookie?: never;
6193
+ };
6194
+ requestBody?: never;
6195
+ responses: {
6196
+ 200: {
6197
+ headers: {
6198
+ [name: string]: unknown;
6199
+ };
6200
+ content: {
6201
+ "application/json": components["schemas"]["PaymentMethodsResponseDto"];
6202
+ };
6203
+ };
6204
+ /** @description Invalid request or unsupported operation. */
6205
+ 400: {
6206
+ headers: {
6207
+ [name: string]: unknown;
6208
+ };
6209
+ content: {
6210
+ "application/json": components["schemas"]["ApiErrorDto"];
6211
+ };
6212
+ };
6213
+ /** @description Missing, invalid, or inactive tenant API key. */
6214
+ 401: {
6215
+ headers: {
6216
+ [name: string]: unknown;
6217
+ };
6218
+ content: {
6219
+ "application/json": components["schemas"]["ApiErrorDto"];
6220
+ };
6221
+ };
6222
+ /** @description Live mode not activated (`live_mode_not_activated`): the live account is pending VEX Pay review or suspended. Test keys are unaffected. */
6223
+ 403: {
6224
+ headers: {
6225
+ [name: string]: unknown;
6226
+ };
6227
+ content: {
6228
+ "application/json": components["schemas"]["ApiErrorDto"];
6229
+ };
6230
+ };
6231
+ /** @description Client error. */
6232
+ "4XX": {
6233
+ headers: {
6234
+ [name: string]: unknown;
6235
+ };
6236
+ content: {
6237
+ "application/json": components["schemas"]["ApiErrorDto"];
6238
+ };
6239
+ };
6240
+ /** @description Server or upstream bank error. */
6241
+ "5XX": {
6242
+ headers: {
6243
+ [name: string]: unknown;
6244
+ };
6245
+ content: {
6246
+ "application/json": components["schemas"]["ApiErrorDto"];
6247
+ };
6248
+ };
6249
+ };
6250
+ };
5931
6251
  Payments_getPagoMovilReceivingAccount: {
5932
6252
  parameters: {
5933
6253
  query?: never;
@@ -8818,7 +9138,7 @@ declare class WebhookEndpoints extends APIResource {
8818
9138
  id: string;
8819
9139
  tenantId: string;
8820
9140
  url: string;
8821
- events: ("payment.pending" | "payment.completed" | "payment.failed" | "payment.canceled" | "payment.reversed" | "payment.chargeback" | "payment.chargeback_closed" | "merchant.verified" | "merchant.rejected" | "merchant.deactivated" | "merchant.reactivated" | "merchant.balance.updated" | "merchant.created" | "merchant.activated" | "merchant.updated" | "merchant.kyb_required" | "merchant.restricted" | "merchant.capability.updated" | "merchant.wallet_credit" | "payout.completed" | "payout.failed" | "conversion.completed" | "conversion.canceled" | "tenant.status_changed" | "tenant.api_key.created" | "tenant.api_key.rotated" | "tenant.api_key.revoked" | "tenant.live_status_changed" | "notification.test")[];
9141
+ events: ("payment.pending" | "payment.completed" | "payment.failed" | "payment.canceled" | "payment.reversed" | "payment.chargeback" | "payment.chargeback_closed" | "merchant.verified" | "merchant.rejected" | "merchant.deactivated" | "merchant.reactivated" | "merchant.balance.updated" | "merchant.created" | "merchant.activated" | "merchant.updated" | "merchant.kyb_required" | "merchant.restricted" | "merchant.capability.updated" | "merchant.wallet_credit" | "payout.completed" | "payout.failed" | "conversion.created" | "conversion.completed" | "conversion.canceled" | "tenant.status_changed" | "tenant.api_key.created" | "tenant.api_key.rotated" | "tenant.api_key.revoked" | "tenant.live_status_changed" | "notification.test")[];
8822
9142
  isActive: boolean;
8823
9143
  createdAt: string;
8824
9144
  secret?: string;
@@ -8827,7 +9147,7 @@ declare class WebhookEndpoints extends APIResource {
8827
9147
  id: string;
8828
9148
  tenantId: string;
8829
9149
  url: string;
8830
- events: ("payment.pending" | "payment.completed" | "payment.failed" | "payment.canceled" | "payment.reversed" | "payment.chargeback" | "payment.chargeback_closed" | "merchant.verified" | "merchant.rejected" | "merchant.deactivated" | "merchant.reactivated" | "merchant.balance.updated" | "merchant.created" | "merchant.activated" | "merchant.updated" | "merchant.kyb_required" | "merchant.restricted" | "merchant.capability.updated" | "merchant.wallet_credit" | "payout.completed" | "payout.failed" | "conversion.completed" | "conversion.canceled" | "tenant.status_changed" | "tenant.api_key.created" | "tenant.api_key.rotated" | "tenant.api_key.revoked" | "tenant.live_status_changed" | "notification.test")[];
9150
+ events: ("payment.pending" | "payment.completed" | "payment.failed" | "payment.canceled" | "payment.reversed" | "payment.chargeback" | "payment.chargeback_closed" | "merchant.verified" | "merchant.rejected" | "merchant.deactivated" | "merchant.reactivated" | "merchant.balance.updated" | "merchant.created" | "merchant.activated" | "merchant.updated" | "merchant.kyb_required" | "merchant.restricted" | "merchant.capability.updated" | "merchant.wallet_credit" | "payout.completed" | "payout.failed" | "conversion.created" | "conversion.completed" | "conversion.canceled" | "tenant.status_changed" | "tenant.api_key.created" | "tenant.api_key.rotated" | "tenant.api_key.revoked" | "tenant.live_status_changed" | "notification.test")[];
8831
9151
  isActive: boolean;
8832
9152
  createdAt: string;
8833
9153
  secret?: string;
@@ -8836,7 +9156,7 @@ declare class WebhookEndpoints extends APIResource {
8836
9156
  id: string;
8837
9157
  tenantId: string;
8838
9158
  url: string;
8839
- events: ("payment.pending" | "payment.completed" | "payment.failed" | "payment.canceled" | "payment.reversed" | "payment.chargeback" | "payment.chargeback_closed" | "merchant.verified" | "merchant.rejected" | "merchant.deactivated" | "merchant.reactivated" | "merchant.balance.updated" | "merchant.created" | "merchant.activated" | "merchant.updated" | "merchant.kyb_required" | "merchant.restricted" | "merchant.capability.updated" | "merchant.wallet_credit" | "payout.completed" | "payout.failed" | "conversion.completed" | "conversion.canceled" | "tenant.status_changed" | "tenant.api_key.created" | "tenant.api_key.rotated" | "tenant.api_key.revoked" | "tenant.live_status_changed" | "notification.test")[];
9159
+ events: ("payment.pending" | "payment.completed" | "payment.failed" | "payment.canceled" | "payment.reversed" | "payment.chargeback" | "payment.chargeback_closed" | "merchant.verified" | "merchant.rejected" | "merchant.deactivated" | "merchant.reactivated" | "merchant.balance.updated" | "merchant.created" | "merchant.activated" | "merchant.updated" | "merchant.kyb_required" | "merchant.restricted" | "merchant.capability.updated" | "merchant.wallet_credit" | "payout.completed" | "payout.failed" | "conversion.created" | "conversion.completed" | "conversion.canceled" | "tenant.status_changed" | "tenant.api_key.created" | "tenant.api_key.rotated" | "tenant.api_key.revoked" | "tenant.live_status_changed" | "notification.test")[];
8840
9160
  isActive: boolean;
8841
9161
  createdAt: string;
8842
9162
  secret?: string;
@@ -8868,7 +9188,7 @@ declare class CheckoutSessions extends APIResource {
8868
9188
  [key: string]: string;
8869
9189
  };
8870
9190
  allowedOrigins: string[];
8871
- methods: ("c2p" | "vpos" | "usdt" | "usdc" | "cop")[];
9191
+ methods: ("c2p" | "pago_movil" | "vpos" | "usdt" | "usdc" | "cop")[];
8872
9192
  successUrl?: string | null;
8873
9193
  cancelUrl?: string | null;
8874
9194
  paymentId?: string | null;
@@ -8889,7 +9209,7 @@ declare class CheckoutSessions extends APIResource {
8889
9209
  [key: string]: string;
8890
9210
  };
8891
9211
  allowedOrigins: string[];
8892
- methods: ("c2p" | "vpos" | "usdt" | "usdc" | "cop")[];
9212
+ methods: ("c2p" | "pago_movil" | "vpos" | "usdt" | "usdc" | "cop")[];
8893
9213
  successUrl?: string | null;
8894
9214
  cancelUrl?: string | null;
8895
9215
  paymentId?: string | null;
@@ -8994,9 +9314,12 @@ declare class PaymentLinks extends APIResource {
8994
9314
  delete(id: string, options?: RequestOptions): Promise<void>;
8995
9315
  }
8996
9316
 
8997
- /** A rate for converting VES to USDT, locked for 60 seconds. */
9317
+ /** A rate for converting VES or COP to USDT, locked for 60 seconds. */
8998
9318
  declare class ConversionQuotes extends APIResource {
8999
- /** Send `sourceAmountVes` (VES to spend) or `targetAmountUsdt` (USDT to receive) — exactly one. */
9319
+ /**
9320
+ * `sourceCurrency` is `'VES'` (default) or `'COP'`. Send `sourceAmount` (to spend; COP in whole pesos)
9321
+ * or `targetAmountUsdt` (USDT to receive) — exactly one. VES may still use `sourceAmountVes`.
9322
+ */
9000
9323
  create(params: RequestBody<'Conversions_createQuote'>, options?: RequestOptions): Promise<{
9001
9324
  id: string;
9002
9325
  object: string;
@@ -9004,18 +9327,44 @@ declare class ConversionQuotes extends APIResource {
9004
9327
  marketRate: string;
9005
9328
  spreadPercent: string;
9006
9329
  rateSource: "market";
9007
- sourceAmountVes: string;
9330
+ sourceCurrency: "VES" | "COP";
9331
+ sourceAmount: string;
9332
+ sourceAmountVes: string | null;
9008
9333
  targetAmountUsdt: string;
9009
9334
  expiresAt: string;
9010
9335
  createdAt: string;
9011
9336
  }>;
9012
9337
  }
9338
+ /** Your conversion spreads, minimum and caps, and COP auto-convert. */
9339
+ declare class ConversionSettings extends APIResource {
9340
+ retrieve(options?: RequestOptions): Promise<{
9341
+ object: string;
9342
+ enabled: boolean;
9343
+ sourceCurrencies: components["schemas"]["CurrencyFlagsDto"];
9344
+ spreadPercent: components["schemas"]["CurrencyAmountsDto"];
9345
+ minimumUsdt: string;
9346
+ dailyMax: components["schemas"]["CurrencyCapsDto"];
9347
+ autoConvert: components["schemas"]["AutoConvertDto"];
9348
+ }>;
9349
+ /** Only `autoConvert.COP.percent` (0–100, whole number; 0 = off) can be changed. */
9350
+ update(params: RequestBody<'ConversionSettings_update'>, options?: RequestOptions): Promise<{
9351
+ object: string;
9352
+ enabled: boolean;
9353
+ sourceCurrencies: components["schemas"]["CurrencyFlagsDto"];
9354
+ spreadPercent: components["schemas"]["CurrencyAmountsDto"];
9355
+ minimumUsdt: string;
9356
+ dailyMax: components["schemas"]["CurrencyCapsDto"];
9357
+ autoConvert: components["schemas"]["AutoConvertDto"];
9358
+ }>;
9359
+ }
9013
9360
  /**
9014
- * Convert available VES into your USDT balance. Accepting a quote debits the VES at once; the
9015
- * conversion is `PENDING` until VEXPay delivers the USDT (`conversion.completed`). Enabled per account.
9361
+ * Convert available VES or COP into your USDT balance. Accepting a quote debits the source at once
9362
+ * (`conversion.created`); the conversion is `PENDING` until VEXPay delivers the USDT
9363
+ * (`conversion.completed`). Enabled per account.
9016
9364
  */
9017
9365
  declare class Conversions extends APIResource {
9018
9366
  readonly quotes: ConversionQuotes;
9367
+ readonly settings: ConversionSettings;
9019
9368
  /** Accept a quote (`quoteId`). Pass `idempotencyKey` in options to retry safely. */
9020
9369
  create(params: RequestBody<'Conversions_create'>, options?: RequestOptions): Promise<{
9021
9370
  id: string;
@@ -9026,8 +9375,12 @@ declare class Conversions extends APIResource {
9026
9375
  marketRate: string;
9027
9376
  spreadPercent: string;
9028
9377
  rateSource: "market";
9029
- sourceAmountVes: string;
9378
+ sourceCurrency: "VES" | "COP";
9379
+ sourceAmount: string;
9380
+ sourceAmountVes: string | null;
9030
9381
  targetAmountUsdt: string;
9382
+ origin: "api" | "auto";
9383
+ paymentId: string | null;
9031
9384
  createdAt: string;
9032
9385
  completedAt: string | null;
9033
9386
  canceledAt: string | null;
@@ -9042,14 +9395,18 @@ declare class Conversions extends APIResource {
9042
9395
  marketRate: string;
9043
9396
  spreadPercent: string;
9044
9397
  rateSource: "market";
9045
- sourceAmountVes: string;
9398
+ sourceCurrency: "VES" | "COP";
9399
+ sourceAmount: string;
9400
+ sourceAmountVes: string | null;
9046
9401
  targetAmountUsdt: string;
9402
+ origin: "api" | "auto";
9403
+ paymentId: string | null;
9047
9404
  createdAt: string;
9048
9405
  completedAt: string | null;
9049
9406
  canceledAt: string | null;
9050
9407
  cancelReason: string | null;
9051
9408
  }>;
9052
- /** Await for one page, or `for await` over every conversion (newest first). */
9409
+ /** Await for one page, or `for await` over every conversion (newest first). Filter with `sourceCurrency`. */
9053
9410
  list(params?: QueryParams<'Conversions_list'>, options?: RequestOptions): PagePromise<{
9054
9411
  items: components["schemas"]["ConversionDto"][];
9055
9412
  nextCursor: string | null;
@@ -9062,14 +9419,18 @@ declare class Conversions extends APIResource {
9062
9419
  marketRate: string;
9063
9420
  spreadPercent: string;
9064
9421
  rateSource: "market";
9065
- sourceAmountVes: string;
9422
+ sourceCurrency: "VES" | "COP";
9423
+ sourceAmount: string;
9424
+ sourceAmountVes: string | null;
9066
9425
  targetAmountUsdt: string;
9426
+ origin: "api" | "auto";
9427
+ paymentId: string | null;
9067
9428
  createdAt: string;
9068
9429
  completedAt: string | null;
9069
9430
  canceledAt: string | null;
9070
9431
  cancelReason: string | null;
9071
9432
  }>;
9072
- /** Cancel a `PENDING` conversion; the VES returns to your available balance. */
9433
+ /** Cancel a `PENDING` conversion; the VES or COP returns to your available balance. */
9073
9434
  cancel(id: string, options?: RequestOptions): Promise<{
9074
9435
  id: string;
9075
9436
  object: string;
@@ -9079,8 +9440,12 @@ declare class Conversions extends APIResource {
9079
9440
  marketRate: string;
9080
9441
  spreadPercent: string;
9081
9442
  rateSource: "market";
9082
- sourceAmountVes: string;
9443
+ sourceCurrency: "VES" | "COP";
9444
+ sourceAmount: string;
9445
+ sourceAmountVes: string | null;
9083
9446
  targetAmountUsdt: string;
9447
+ origin: "api" | "auto";
9448
+ paymentId: string | null;
9084
9449
  createdAt: string;
9085
9450
  completedAt: string | null;
9086
9451
  canceledAt: string | null;
@@ -9765,6 +10130,11 @@ declare class Payments extends APIResource {
9765
10130
  readonly operations: Operations;
9766
10131
  readonly dispersals: Dispersals;
9767
10132
  readonly change: Change;
10133
+ /** Bolívar methods your account can take now (`pago_movil`, `c2p`, `vpos`), with a reason when unavailable. */
10134
+ methods(options?: RequestOptions): Promise<{
10135
+ livemode: boolean;
10136
+ methods: components["schemas"]["PaymentMethodAvailabilityDto"][];
10137
+ }>;
9768
10138
  retrieve(id: string, options?: RequestOptions): Promise<{
9769
10139
  paymentId: string;
9770
10140
  externalRef?: string;
@@ -9856,7 +10226,7 @@ declare class Payments extends APIResource {
9856
10226
  }>;
9857
10227
  }
9858
10228
 
9859
- declare const WEBHOOK_EVENT_NAMES: readonly ["payment.pending", "payment.completed", "payment.failed", "payment.canceled", "payment.reversed", "payment.chargeback", "payment.chargeback_closed", "merchant.verified", "merchant.rejected", "merchant.deactivated", "merchant.reactivated", "merchant.balance.updated", "merchant.created", "merchant.activated", "merchant.updated", "merchant.kyb_required", "merchant.restricted", "merchant.capability.updated", "merchant.wallet_credit", "payout.completed", "payout.failed", "conversion.completed", "conversion.canceled", "tenant.status_changed", "tenant.api_key.created", "tenant.api_key.rotated", "tenant.api_key.revoked", "tenant.live_status_changed", "notification.test"];
10229
+ declare const WEBHOOK_EVENT_NAMES: readonly ["payment.pending", "payment.completed", "payment.failed", "payment.canceled", "payment.reversed", "payment.chargeback", "payment.chargeback_closed", "merchant.verified", "merchant.rejected", "merchant.deactivated", "merchant.reactivated", "merchant.balance.updated", "merchant.created", "merchant.activated", "merchant.updated", "merchant.kyb_required", "merchant.restricted", "merchant.capability.updated", "merchant.wallet_credit", "payout.completed", "payout.failed", "conversion.created", "conversion.completed", "conversion.canceled", "tenant.status_changed", "tenant.api_key.created", "tenant.api_key.rotated", "tenant.api_key.revoked", "tenant.live_status_changed", "notification.test"];
9860
10230
  type WebhookEventName = (typeof WEBHOOK_EVENT_NAMES)[number];
9861
10231
  /** `data` of every `payment.*` event. */
9862
10232
  interface PaymentWebhookData {
@@ -10043,6 +10413,6 @@ declare class VexPayTimeoutError extends VexPayConnectionError {
10043
10413
  declare class VexPaySignatureVerificationError extends VexPayError {
10044
10414
  }
10045
10415
 
10046
- declare const VERSION = "0.6.0";
10416
+ declare const VERSION = "0.8.0";
10047
10417
 
10048
10418
  export { type CopPaymentWebhookData, type CursorPage, DEFAULT_BASE_URL, DEFAULT_TOLERANCE_SECONDS, type OperationId, PagePromise, type PathParams, type PaymentWebhookData, type QueryParams, type RequestBody, type RequestOptions, type ResponseBody, SIGNATURE_HEADER, type Schemas, VERSION, VexPay, VexPayAPIError, VexPayAuthenticationError, VexPayConfigurationError, VexPayConflictError, VexPayConnectionError, VexPayError, VexPayInvalidRequestError, VexPayNotFoundError, type VexPayOptions, VexPayRateLimitError, VexPaySignatureVerificationError, VexPayTimeoutError, WEBHOOK_EVENT_NAMES, type WebhookEvent, type WebhookEventName, Webhooks, VexPay as default };