From e24214949424f354708a658c7b747588c3dac750 Mon Sep 17 00:00:00 2001 From: Francisca Otero Date: Mon, 16 Nov 2026 12:04:15 +0000 Subject: [PATCH] feat(crossborder): add cancel and simulateCredit to v2 crossborder transfers Co-authored-by: fin-compose[bot] <255610621+fin-compose[bot]@users.noreply.github.com> --- README.md | 5 +++ .../v2/crossborderTransfersManager.ts | 17 ++++++- src/spec/integration.spec.ts | 44 +++++++++++++++++++ 3 files changed, 65 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 0deb90f..521e39b 100644 --- a/README.md +++ b/README.md @@ -376,6 +376,11 @@ const transfers = await fintocClient.v2.crossborder.transfers.list({ direction: 'mx_to_usd', }); +const canceledTransfer = await fintocClient.v2.crossborder.transfers.cancel('xbt_12345678'); + +// Test mode only: simulates the credit of a transfer +const creditedTransfer = await fintocClient.v2.crossborder.transfers.simulateCredit('xbt_87654321'); + await fintocClient.v2.crossborder.beneficiaries.delete(beneficiary.id); ``` diff --git a/src/lib/managers/v2/crossborderTransfersManager.ts b/src/lib/managers/v2/crossborderTransfersManager.ts index 23c7c04..b3ff2cc 100644 --- a/src/lib/managers/v2/crossborderTransfersManager.ts +++ b/src/lib/managers/v2/crossborderTransfersManager.ts @@ -1,7 +1,22 @@ +import { ResourceArguments } from '../../../types'; import { ManagerMixin } from '../../mixins'; import { CrossborderTransfer } from '../../resources/v2/crossborderTransfer'; export class CrossborderTransfersManager extends ManagerMixin { static resource = 'crossborder_transfer'; - static methods = ['list', 'get', 'create']; + static methods = ['list', 'get', 'create', 'cancel', 'simulateCredit']; + + cancel(identifier: string, args?: ResourceArguments) { + const innerArgs = args || {}; + const path = `${this.buildPath()}/${identifier}/cancel`; + + return this._create({ path_: path, ...innerArgs }); + } + + simulateCredit(identifier: string, args?: ResourceArguments) { + const innerArgs = args || {}; + const path = `${this.buildPath()}/${identifier}/simulate_credit`; + + return this._create({ path_: path, ...innerArgs }); + } } diff --git a/src/spec/integration.spec.ts b/src/spec/integration.spec.ts index 8462850..dfc6221 100644 --- a/src/spec/integration.spec.ts +++ b/src/spec/integration.spec.ts @@ -2545,6 +2545,50 @@ test('fintoc.v2.crossborder.transfers.get()', async (t) => { t.is(transfer.url, `v2/crossborder/transfers/${transferId}`); }); +test('fintoc.v2.crossborder.transfers.cancel()', async (t) => { + const ctx: any = t.context; + const transferId = 'xbt_12345'; + const transfer = await ctx.fintoc.v2.crossborder.transfers.cancel(transferId); + + t.is(transfer.constructor.name, 'CrossborderTransfer'); + t.is(transfer.method, 'post'); + t.is(transfer.url, `v2/crossborder/transfers/${transferId}/cancel`); + t.true(transfer.headers['Idempotency-Key'] && transfer.headers['Idempotency-Key'].length > 0); +}); + +test('fintoc.v2.crossborder.transfers.cancel() with idempotency key', async (t) => { + const ctx: any = t.context; + const transferId = 'xbt_12345'; + const transfer = await ctx.fintoc.v2.crossborder.transfers.cancel(transferId, { + idempotency_key: 'idem_123', + }); + + t.is(transfer.headers['Idempotency-Key'], 'idem_123'); + t.is(transfer.json.idempotency_key, undefined); +}); + +test('fintoc.v2.crossborder.transfers.simulateCredit()', async (t) => { + const ctx: any = t.context; + const transferId = 'xbt_12345'; + const transfer = await ctx.fintoc.v2.crossborder.transfers.simulateCredit(transferId); + + t.is(transfer.constructor.name, 'CrossborderTransfer'); + t.is(transfer.method, 'post'); + t.is(transfer.url, `v2/crossborder/transfers/${transferId}/simulate_credit`); + t.true(transfer.headers['Idempotency-Key'] && transfer.headers['Idempotency-Key'].length > 0); +}); + +test('fintoc.v2.crossborder.transfers.simulateCredit() with idempotency key', async (t) => { + const ctx: any = t.context; + const transferId = 'xbt_12345'; + const transfer = await ctx.fintoc.v2.crossborder.transfers.simulateCredit(transferId, { + idempotency_key: 'idem_123', + }); + + t.is(transfer.headers['Idempotency-Key'], 'idem_123'); + t.is(transfer.json.idempotency_key, undefined); +}); + test('fintoc.v2.entities.settlementAccount()', async (t) => { const ctx: any = t.context; const entityId = 'ent_12345';