Welcome to FV Merchant APIs.
\nThese APIs enable merchants and platforms to manage beneficiaries, configure payment methods, and send payments programmatically.
\nThe API is designed around common financial workflows such as sending money, tracking transactions, and managing recipients. Instead of interacting with isolated endpoints, developers are encouraged to follow use-case-based flows for faster and more reliable integration.
\nTo get started, authenticate your requests and follow the step-by-step guides under βUse Casesβ.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"19084463","collectionId":"9989b5a7-533a-4fe1-80fd-6a72f2f901d9","publishedId":"2sBXqFLgno","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-04-21T08:09:18.000Z"},"item":[{"name":"π Getting Started","item":[{"name":"Authentication","item":[],"id":"0b28b4ba-8622-457f-adf2-ed678010a85b","description":"FV Merchant APIs use a secure JWT-based authentication mechanism.
\nTo access the APIs, you must first generate a SessionToken. This is done using a two-step process:
\nStep 1: Generate JWT
Create a signed JWT using your ClientID and ClientSecret. This token is short-lived and is used only to authenticate with the /auth endpoint.
Example (Node.js):
\nconst jwt = require('jsonwebtoken');\nconst clientID = \"your_client_id\";\nconst clientSecret = \"your_client_secret\";\nconst payload = {\n ClientID: clientID,\n iat: Math.floor(Date.now() / 1000),\n exp: Math.floor(Date.now() / 1000) + (60 * 5) // expires in 5 minutes\n};\nconst token = jwt.sign(payload, clientSecret);\nconsole.log(\"Generated JWT:\", token);\n\nStep 2: Get Session Token
Send the generated JWT in the X-AUTH-TOKEN header to the /auth endpoint. A SessionToken will be returned in the response.
π Get Session Token (Node.js)
\nUse your pre-generated JWT to authenticate with the /auth endpoint and receive a SessionToken.
Notes:
\nPass the JWT in the X-AUTH-TOKEN header
The response will contain a SessionToken
\nUse the SessionToken for all subsequent API requests
\nconst axios = require('axios');\n// π Your pre-generated JWT\nconst JWT_TOKEN = 'your_generated_jwt_token_here';\n// π Base URL\nconst BASE_URL = 'https://sandbox.merchant.fvbank.us/v2';\nasync function getSessionToken() {\n try {\n const response = await axios.get(\n `${BASE_URL}/auth`,\n {\n headers: {\n 'Content-Type': 'application/json',\n 'X-AUTH-TOKEN': JWT_TOKEN\n }\n }\n );\n console.log('Session Token Response:', response.data);\n return response.data;\n } catch (error) {\n console.error(\n 'Error:',\n error.response?.data || error.message\n );\n }\n}\ngetSessionToken();\n\nStep 3: Use Session Token
Include the SessionToken in the X-AUTH-TOKEN header for all subsequent API requests.
Authentication Flow:
\nClient Credentials β Generate JWT β Call /auth β Receive SessionToken β Use SessionToken for API Calls
\nImportant Notes:
\nJWT is short-lived (~5 minutes) and used only for authentication
\nSessionToken validity depends on the expiration (exp) defined in the JWT used during authentication.
\nA refreshed token may be returned in the x-refresh-token header
Always reuse SessionToken until it expires
\nRegenerate token if you receive authentication errors (401)
\nRequests must originate from the same IP used during authentication
\nThis example demonstrates how to make your first authenticated API call using the SessionToken. Before proceeding, ensure you have successfully generated a SessionToken using the Authentication step.
\nAll API requests must include the Authorization in the request header:
\nAuthorization: 'Bearer <SessionToken>'\n\nWhile making API calls, you may receive a refreshed token in the response header:
\nx-refresh-token: <new_session_token>\n\nThis indicates that your current SessionToken is nearing expiration.
\nRecommended handling:
\nReplace the existing SessionToken with the new x-refresh-token
Use the refreshed token for all subsequent API requests
\nThis ensures uninterrupted API access without re-authentication
\nAlways include Authorization header in every request
Do not reuse expired tokens
\nIf a request fails with 401 Unauthorized, regenerate the SessionToken via /auth
Cache and reuse tokens until expiry to avoid unnecessary auth calls
\nGET https://docs.apis.fvbank.us/v2/accounts/balance\n\nHeaders:
\nX-AUTH-TOKEN: \n\n{\n ResponseCode: 200,\n ResponseMessage: 'Success',\n ResponseData: [\n {\n Balance: '23997.98',\n ReservedAmount: '0.00',\n AvailableBalance: '23997.98',\n Currency: 'USD',\n Name: 'Account (USD)',\n Id: '637403491'\n },\n {\n Balance: '0.00000000',\n ReservedAmount: '0.00000000',\n AvailableBalance: '0.00000000',\n Currency: 'BTC',\n Name: 'Custody (BTC)',\n Id: '240122737'\n },\n {\n Balance: '0.00000000',\n ReservedAmount: '0.00000000',\n AvailableBalance: '0.00000000',\n Currency: 'DOGE',\n Name: 'Custody (DOGE)',\n Id: '322781227'\n },\n {\n Balance: '0.000000000',\n ReservedAmount: '0.000000000',\n AvailableBalance: '0.000000000',\n Currency: 'DOT',\n Name: 'Custody (DOT)',\n Id: '255877064'\n },\n {\n Balance: '0.000000000',\n ReservedAmount: '0.000000000',\n AvailableBalance: '0.000000000',\n Currency: 'ETH',\n Name: 'Custody (ETH)',\n Id: '127822708'\n },\n {\n Balance: '0.000000000',\n ReservedAmount: '0.000000000',\n AvailableBalance: '0.000000000',\n Currency: 'MATIC',\n Name: 'Custody (MATIC)',\n Id: '226960488'\n },\n {\n Balance: '0.000000',\n ReservedAmount: '0.000000',\n AvailableBalance: '0.000000',\n Currency: 'USDC',\n Name: 'Custody (USDC)',\n Id: '554068538'\n },\n {\n Balance: '0.000000',\n ReservedAmount: '0.000000',\n AvailableBalance: '0.000000',\n Currency: 'USDT',\n Name: 'Custody (USDT)',\n Id: '685060867'\n },\n {\n Balance: '5000.00',\n ReservedAmount: '0.00',\n AvailableBalance: '5000.00',\n Currency: 'USD',\n Name: 'Custody Account (USD)',\n Id: '085281546'\n },\n {\n Balance: '0.00',\n ReservedAmount: '0.00',\n AvailableBalance: '0.00',\n Currency: 'USD',\n Name: 'Custody Money Market Account (USD)',\n Id: '827001647'\n }\n ]\n}\n\nconst axios = require('axios');\nconst baseUrl = \"https://sandbox.merchant.fvbank.us/v2\";\nconst sessionToken = \"your_session_token\";\nasync function getAccountBalance() {\n try {\n const response = await axios.get(`${baseUrl}/account/balance`, {\n headers: {\n \"Authorization\": `Bearer ${sessionToken}`,\n \"Content-Type\": \"application/json\"\n }\n });\n const data = response.data;\n console.log(\"Account Balance:\", data);\n // Optional: handle refresh token\n const refreshToken = response.headers[\"x-refresh-token\"];\n if (refreshToken) {\n console.log(\"New Session Token:\", refreshToken);\n }\n } catch (error) {\n console.error(\n \"Error fetching account balance:\",\n error.response?.data || error.message\n );\n }\n}\ngetAccountBalance();\n\nOnce you are able to make authenticated API calls, you can:
\nCreate a Beneficiary
\nAdd a Payment Method
\nInitiate a Payment
\nTrack Transactions
\nOr follow the Send Money use case for a complete end-to-end flow.
\n","_postman_id":"dafa3247-6340-45df-95e3-6d6a34409343"}],"id":"d104869c-6b6b-4508-a6d5-470c141e8b10","description":"Welcome to FV Merchant APIs.
\nThis guide will help you quickly get started with integrating our APIs to manage beneficiaries, configure payment methods, and initiate payments.
\nAll API requests are secured using a two-step authentication process:
\nGenerate a short-lived JWT using your ClientID and ClientSecret
\nExchange the JWT for a SessionToken via the /auth endpoint
\nOnce authenticated, the SessionToken must be included in all API requests.
\nFor a complete integration, follow these steps:
\nAuthenticate using your credentials
\nCreate a beneficiary
\nAdd a payment method
\nInitiate a payment
\nTrack the transaction
\nRefer to the \"Use Cases\" section for step-by-step flows.
\n","_postman_id":"d104869c-6b6b-4508-a6d5-470c141e8b10"},{"name":"π§ Use Cases","item":[{"name":"π³ Send Money","item":[],"id":"bb2a9e1f-b37f-4295-8dad-c493125ee447","description":"This use case demonstrates how to send a bank payment from your FV account to a beneficiary using Domestic ACH (USD).
\nThe same flow can be used for other fiat payment types (e.g., Wire). Only the Payment_Type and related banking details need to be adjusted based on the payment method.
Create Beneficiary β Add Payment Instrument β Upload File β Initiate Payment β Track Transaction\n\nBeneficiaryID β PaymentInstrumentID β FileId β TransactionID\n\nA valid SessionToken
Include the following header in all requests:
\nX-AUTH-TOKEN: \n\nFileIdasync function createBeneficiary() {\n try {\n const response = await axios.post(\n `${baseUrl}/beneficiary/create`,\n [\n { \"field\": \"Beneficiary_Type\", \"value\": \"individual\" },\n { \"field\": \"Beneficiary_Email\", \"value\": \"john.doe@example.com\" },\n { \"field\": \"Beneficiary_Address\", \"value\": \"123 Main Street\" },\n { \"field\": \"Beneficiary_City\", \"value\": \"New York\" },\n { \"field\": \"Beneficiary_Postal_Code\", \"value\": \"10001\" },\n { \"field\": \"Beneficiary_Country\", \"value\": \"US\" },\n { \"field\": \"Beneficiary_State\", \"value\": \"NY\" },\n { \"field\": \"Beneficiary_First_Name\", \"value\": \"John\" },\n { \"field\": \"Beneficiary_Last_Name\", \"value\": \"Doe\" },\n { \"field\": \"Beneficiary_DOB\", \"value\": \"1990-01-01\" }\n ],\n {\n headers: {\n \"Authorization\": `Bearer ${sessionToken}`,\n \"Content-Type\": \"application/json\"\n }\n }\n );\n console.log(response.data);\n } catch (error) {\n console.error(\n \"Error:\",\n error.response?.data || error.message\n );\n }\n}\ncreateBeneficiary();\n\nResponse:
\n{\n \"ResponseData\": {\n \"BeneficiaryId\": \"4650983997967871956\",\n \"message\": \"Please allow 10 minutes for the beneficiary to turn Active. Once the beneficiary status is Active, You can create payment instruments.\"\n }\n}\n\nasync function createACHInstrument() {\n try {\n const response = await axios.post(\n `${baseUrl}/payment-instrument/create`,\n [\n {\n \"field\": \"Payment_Type\",\n \"value\": \"BUS_USD_Account.Business_ACH\"\n },\n {\n \"field\": \"BeneficiaryId\",\n \"value\": \"-6360317090952990964\"\n },\n {\n \"field\": \"Nickname\",\n \"value\": \"Domestic-ACH-Instrument\"\n },\n {\n \"field\": \"Account_Number\",\n \"value\": \"8787627\"\n },\n {\n \"field\": \"Routing_Number\",\n \"value\": \"026009593\"\n },\n {\n \"field\": \"Account_Type\",\n \"value\": \"Saving\"\n }\n ],\n {\n headers: {\n \"Authorization\": `Bearer ${sessionToken}`,\n \"Content-Type\": \"application/json\"\n }\n }\n );\n console.log(\"Payment Instrument Created:\", response.data);\n } catch (error) {\n console.error(\n \"Error creating payment instrument:\",\n error.response?.data || error.message\n );\n }\n}\ncreateACHInstrument();\n\nResponse:
\n{\n ResponseCode: 200,\n ResponseMessage: 'Success',\n ResponseData: { PaymentInstrumentID: '-6477410681264623860' }\n}\n\nUse this endpoint to upload supporting documents (e.g., invoices) that can be attached to payments or other workflows.
\nconst axios = require('axios');\nconst fs = require('fs');\nconst baseUrl = \"https://sandbox.merchant.fvbank.us/v2\";\nconst sessionToken = \"your_session_token_here\";\n// π Update file path accordingly\nconst filePath = \"/Users/rishav/Documents/Sample/Form_6_English.pdf\";\nasync function uploadFile() {\n try {\n const response = await axios.post(\n `${baseUrl}/files/upload?customField=Payment_Invoice&fileName=Ducket.pdf`,\n fs.createReadStream(filePath),\n {\n headers: {\n \"Authorization\": `Bearer ${sessionToken}`,\n \"Content-Type\": \"application/pdf\"\n },\n maxBodyLength: Infinity\n }\n );\n console.log(\"File Uploaded:\", response.data);\n } catch (error) {\n console.error(\n \"Error uploading file:\",\n error.response?.data || error.message\n );\n }\n}\nuploadFile();\n\nRefer to the Files Upload endpoint in the API Reference section to better understand:
\nSupported file types
\nRequired query parameters (customField, fileName)
How uploaded files are used across flows (e.g., attaching documents to payments)
\n{\n \"ResponseCode\": 200,\n \"ResponseMessage\": \"Success\",\n \"ResponseData\": {\n \"ID\": \"-4004934485838221358\"\n }\n}\n\nπ³ Create Bank Payment (Node.js)
\nUse this endpoint to initiate a bank payment (e.g., ACH/Wire) using a previously created payment instrument.
\nconst axios = require('axios');\nconst baseUrl = \"https://sandbox.merchant.fvbank.us/v2\";\nconst sessionToken = \"your_session_token_here\";\nasync function createBankPayment() {\n try {\n const response = await axios.post(\n `${baseUrl}/payment/bank`,\n {\n \"BeneficiaryPaymentInstrumentID\": \"-6391842288344584436\",\n \"Purpose\": \"Loan_Payments\",\n \"Currency\": \"USD\",\n \"Amount\": \"40\",\n \"CryptoBuySellActivity\": \"No\",\n \"Intermediary_ABA\": \"026001591\",\n \"SupportingDocument\": \"-4004934485838221358\",\n \"Description\": \"lorem ipsum\"\n },\n {\n headers: {\n \"Authorization\": `Bearer ${sessionToken}`,\n \"Content-Type\": \"application/json\"\n }\n }\n );\n console.log(\"Payment Created:\", response.data);\n } catch (error) {\n console.error(\n \"Error creating payment:\",\n error.response?.data || error.message\n );\n }\n}\ncreateBankPayment();\n\nBeneficiaryPaymentInstrumentID is obtained from the Create Payment Instrument step
SupportingDocument is the File ID received after uploading a file via the Files Upload endpoint
Ensure all required compliance fields (e.g., Purpose, Description) are provided correctly
\n{\n \"ResponseCode\": 200,\n \"ResponseMessage\": \"Success\",\n \"ResponseData\": {\n \"TransactionNumber\": \"FV000007938\"\n }\n}\n\nUse this endpoint to fetch detailed information about a specific transaction using the TransactionNumber.
const axios = require('axios');\nconst baseUrl = \"https://sandbox.merchant.fvbank.us/v2\";\nconst sessionToken = \"your_session_token_here\";\n// π Replace with your actual Transaction Number\nconst transactionNumber = \"FV000462103\";\nasync function getTransactionDetails() {\n try {\n const response = await axios.get(\n `${baseUrl}/transactions/details/${transactionNumber}`,\n {\n headers: {\n \"Authorization\": `Bearer ${sessionToken}`\n }\n }\n );\n console.log(\"Transaction Details:\", response.data);\n } catch (error) {\n console.error(\n \"Error fetching transaction details:\",\n error.response?.data || error.message\n );\n }\n}\ngetTransactionDetails();\n\nTransactionNumber is obtained from:
Payment creation response
\nTransaction listing APIs
\nWebhook payloads
\nUse this endpoint to:
\nTrack transaction status
\nView complete transaction details
\nReconcile payments in your system
\nMissing or invalid SessionToken
Incorrect BeneficiaryID or PaymentInstrumentID
Missing SupportingDocument when required
Invalid bank details (routing/account number)
\nExpired session without refresh handling
\nBeneficiaryID β PaymentInstrumentID β FileId β TransactionID\n\nThis flow can be reused for all fiat payment types by adjusting the Payment_Type and required banking details.
This use case demonstrates how to send stablecoin payments (e.g., PYUSD, USDC) from your FV account to a blockchain address.
\nStablecoin payments allow you to transfer digital dollars over blockchain networks while funding the transaction from your USD account.
\nYou initiate a payment in USD
\nThe equivalent value is converted and sent as a stablecoin (PYUSD / USDC)
\nFunds are primarily deducted from your Account USD balance
\nIf enabled on your account:
\nIf the USD account balance is insufficient
\nThe remaining amount is automatically deducted from your Custody USD balance
\n\n\nβ οΈ This feature is enabled on-demand for specific merchants
\n
Create Beneficiary β Add Wallet Address (Payment Instrument) β Initiate Payment β Track Transaction\n\nBeneficiaryID β PaymentInstrumentID β TransactionID\n\nA valid SessionToken
Include the following header in all requests:
\nX-AUTH-TOKEN: \n\nBeneficiary must be created
\nWallet address must be added as a payment instrument
\n(Same as bank payments)
\nasync function createBeneficiary() {\n try {\n const response = await axios.post(\n `${baseUrl}/beneficiary/create`,\n [\n { \"field\": \"Beneficiary_Type\", \"value\": \"individual\" },\n { \"field\": \"Beneficiary_Email\", \"value\": \"john.doe@example.com\" },\n { \"field\": \"Beneficiary_Address\", \"value\": \"123 Main Street\" },\n { \"field\": \"Beneficiary_City\", \"value\": \"New York\" },\n { \"field\": \"Beneficiary_Postal_Code\", \"value\": \"10001\" },\n { \"field\": \"Beneficiary_Country\", \"value\": \"US\" },\n { \"field\": \"Beneficiary_State\", \"value\": \"NY\" },\n { \"field\": \"Beneficiary_First_Name\", \"value\": \"John\" },\n { \"field\": \"Beneficiary_Last_Name\", \"value\": \"Doe\" },\n { \"field\": \"Beneficiary_DOB\", \"value\": \"1990-01-01\" }\n ],\n {\n headers: {\n \"Authorization\": `Bearer ${sessionToken}`,\n \"Content-Type\": \"application/json\"\n }\n }\n );\n console.log(response.data);\n } catch (error) {\n console.error(\n \"Error:\",\n error.response?.data || error.message\n );\n }\n}\ncreateBeneficiary();\n\nπͺ Create Stablecoin Payment Instrument (Node.js)
\nUse this endpoint to create a crypto wallet payment instrument (e.g., USDC) for a beneficiary.
\nconst axios = require('axios');\nconst baseUrl = \"https://sandbox.merchant.fvbank.us/v2\";\nconst sessionToken = \"your_session_token_here\";\nasync function createStablecoinInstrument() {\n try {\n const response = await axios.post(\n `${baseUrl}/payment-instruments/create`,\n [\n { \"field\": \"Payment_Type\", \"value\": \"CRYPTO_WALLET.USDC\" },\n { \"field\": \"BeneficiaryId\", \"value\": \"ben_12345\" },\n { \"field\": \"Nickname\", \"value\": \"Mark USDC Wallet\" },\n { \"field\": \"Address\", \"value\": \"0xA1b2C3d4E5f6...\" },\n { \"field\": \"Blockchain\", \"value\": \"ETH\" },\n { \"field\": \"Asset\", \"value\": \"USDC\" }\n ],\n {\n headers: {\n \"X-AUTH-TOKEN\": sessionToken,\n \"Content-Type\": \"application/json\"\n }\n }\n );\n console.log(\"Stablecoin Instrument Created:\", response.data);\n } catch (error) {\n console.error(\n \"Error creating stablecoin payment instrument:\",\n error.response?.data || error.message\n );\n }\n}\ncreateStablecoinInstrument();\n\nResponse:
\n{\n ResponseCode: 200,\n ResponseMessage: 'Success',\n ResponseData: { PaymentInstrumentID: '-6477410681264623860' }\n}\n\nπ Note
\nBeneficiaryId must be created beforehand using the Create Beneficiary API
Address should be a valid blockchain wallet address
Ensure Blockchain and Asset match (e.g., ETH + USDC)
The response will include a PaymentInstrumentID used for initiating stablecoin payments
\nπͺ Create Stablecoin Payment (Node.js)
\nUse this endpoint to initiate a stablecoin withdrawal (e.g., USDC, PYUSD) to a beneficiaryβs crypto wallet.
\nconst axios = require('axios');\nconst baseUrl = \"https://sandbox.merchant.fvbank.us/v2\";\nconst sessionToken = \"your_session_token_here\";\nasync function createStablecoinPayment() {\n try {\n const response = await axios.post(\n `${baseUrl}/stablecoin/withdraw`,\n {\n \"BeneficiaryPaymentInstrumentID\": \"pi_crypto_123\",\n \"Amount\": \"100\",\n \"Description\": \"Stablecoin payout\"\n },\n {\n headers: {\n \"X-AUTH-TOKEN\": sessionToken,\n \"Content-Type\": \"application/json\"\n }\n }\n );\n console.log(\"Stablecoin Payment Created:\", response.data);\n } catch (error) {\n console.error(\n \"Error creating stablecoin payment:\",\n error.response?.data || error.message\n );\n }\n}\ncreateStablecoinPayment();\n\nBeneficiaryPaymentInstrumentID must refer to a crypto wallet instrument
The equivalent USD amount will be deducted from your account
\nIf Smart Sweep is enabled, insufficient balance may be covered from custody funds
\nUse this endpoint to send stablecoins like USDC or PYUSD to external wallets
\nResponse:
\n{\n \"ResponseCode\": 200,\n \"ResponseMessage\": \"Success\",\n \"ResponseData\": {\n \"TransactionNumber\": \"FV000007976\"\n }\n}\n\nπ Track Transaction Status
\nOnce a payment is created, you can track its progress using the Transaction Details API. This helps you monitor both compliance status and execution status of the transaction.
\nUse the TransactionNumber received during payment creation to fetch the latest status:
const axios = require('axios');\nconst baseUrl = \"https://sandbox.merchant.fvbank.us/v2\";\nconst sessionToken = \"your_session_token_here\";\n// π Replace with your Transaction Number\nconst transactionNumber = \"FV000694629\";\nasync function getTransactionDetails() {\n try {\n const response = await axios.get(\n `${baseUrl}/transactions/details/${transactionNumber}`,\n {\n headers: {\n \"Authorization\": `Bearer ${sessionToken}`\n }\n }\n );\n console.log(\"Transaction Details:\", response.data);\n } catch (error) {\n console.error(\n \"Error fetching transaction details:\",\n error.response?.data || error.message\n );\n }\n}\ngetTransactionDetails();\n\n{\n \"ResponseCode\": 200,\n \"ResponseMessage\": \"Success\",\n \"ResponseData\": {\n \"TransactionNumber\": \"FV000694629\",\n \"CreatedAt\": \"2026-04-10T05:45:45.516-04:00\",\n \"Amount\": \"0.01\",\n \"From\": \"Rishav LLC\",\n \"To\": \"USDC Wallet\",\n \"Currency\": \"USD\",\n \"Description\": \"lorem ipsum\",\n \"Type\": {\n \"value\": \"BUS_USD_Account.Stablecoin_Withdraw\",\n \"label\": \"Stablecoin Payment\"\n },\n \"AdditionalData\": [\n {\n \"label\": \"Destination Currency\",\n \"value\": \"USDC\"\n },\n {\n \"label\": \"Beneficiary First Name\",\n \"value\": \"Rishav\"\n },\n {\n \"label\": \"Beneficiary Last Name\",\n \"value\": \"Upadhayay\"\n },\n {\n \"label\": \"Originator Blockchain\",\n \"value\": \"ETH\"\n },\n {\n \"label\": \"Gateway\",\n \"value\": \"Circle\"\n }\n ],\n \"Status\": \"PENDING_AUTHORIZATION\"\n }\n}\n\nThe Status field represents the current stage of the transaction:
PENDING_AUTHORIZATION β Awaiting compliance approval
AUTHORIZED β Approved and ready for processing
IN_PROCESS β Payment is being processed
COMPLETED β Funds successfully transferred
FAILED β Payment failed
CANCELLED β Cancelled by compliance
The response also includes an AdditionalData array with extended information such as:
Destination currency (e.g., USDC)
\nBlockchain network
\nBeneficiary details
\nProcessing gateway (e.g., Circle)
\nCreate Payment β Get TransactionNumber β Track via API / Webhooks\n\nπͺ Stablecoin Deposits
\nFV Bank also supports receiving stablecoins.
\nEach merchant is assigned a unique blockchain deposit address
\nFunds sent to this address are credited to the merchant account
\nExternal Wallet β FV Deposit Address β Custody Balance β Account Balance (if applicable)\n\nDeposit addresses are provided by FV Bank
\nSupported assets include USDC, PYUSD
\nDeposits are processed after blockchain confirmations
\nInvalid wallet address
\nUnsupported network
\nInsufficient USD balance
\nSmart sweep not enabled (if relying on custody funds)
\nExpired SessionToken
\nBeneficiaryID β PaymentInstrumentID β TransactionID\n\nStablecoin payments enable fast, global transfers using blockchain rails while maintaining USD-based accounting.
\n","_postman_id":"bedef6db-ec69-4471-8d9f-6d8f386a12c9"},{"name":"π¦ Create Virtual Account","item":[],"id":"205f2136-21c9-4cca-9b8b-ca9ab1c4f896","description":"Virtual Accounts are unique account numbers assigned to each beneficiary, enabling you to receive deposits and automatically map incoming funds to the correct beneficiary.
\nThese accounts are created along with the beneficiary by including additional fields in the beneficiary creation request.
\nAssign dedicated deposit instructions per beneficiary
\nAutomatically reconcile incoming deposits
\nIdentify deposit source using Virtual Account identifier
\nCreate a beneficiary with virtual account details
\nFVBank generates a virtual account number + deposit instructions
\nShare deposit instructions from get transaction details endpoint with your beneficiary
\nWhen funds are received:
\nA transaction is created
\nA Virtual Account identifier is included
\nUse this identifier to map deposits to the correct beneficiary
\nconst axios = require('axios');\nconst baseUrl = \"https://sandbox.merchant.fvbank.us/v2\";\nconst sessionToken = \"your_session_token_here\";\nasync function createVirtualAccount() {\n try {\n const response = await axios.post(\n `${baseUrl}/beneficiary/create`,\n [\n { \"field\": \"Beneficiary_Type\", \"value\": \"individual\" },\n { \"field\": \"Beneficiary_Email\", \"value\": \"john@fvbank.us\" },\n { \"field\": \"Beneficiary_Address\", \"value\": \"1437 VIP Road\" },\n { \"field\": \"Beneficiary_City\", \"value\": \"Agra\" },\n { \"field\": \"Beneficiary_Postal_Code\", \"value\": \"282001\" },\n { \"field\": \"Beneficiary_Country\", \"value\": \"IN\" },\n { \"field\": \"Beneficiary_State\", \"value\": \"UP\" },\n { \"field\": \"Beneficiary_First_Name\", \"value\": \"Jon\" },\n { \"field\": \"Beneficiary_Last_Name\", \"value\": \"Doe\" },\n {\n \"field\": \"Beneficiary_Document\",\n \"value\": [\n { \"field\": \"ID_Type\", \"value\": \"Driving_License\" },\n { \"field\": \"ID_Number\", \"value\": \"X12345679\" },\n { \"field\": \"ID_Expiration_Date\", \"value\": \"2027-12-01\" },\n { \"field\": \"Front_Document\", \"value\": \"{{FileId}}\" },\n { \"field\": \"Back_Document\", \"value\": \"-8911389245460361003\" }\n ]\n }\n ],\n {\n headers: {\n \"Authorization\": `Bearer ${sessionToken}`,\n \"Content-Type\": \"application/json\"\n }\n }\n );\n console.log(\"Virtual Account Created:\", response.data);\n } catch (error) {\n console.error(\n \"Error creating virtual account:\",\n error.response?.data || error.message\n );\n }\n}\ncreateVirtualAccount();\n\nAfter creating the virtual account, fetch beneficiary details to retrieve deposit instructions:
\nconst axios = require('axios');\nconst baseUrl = \"https://sandbox.merchant.fvbank.us/v2\";\nconst sessionToken = \"your_session_token_here\";\n// π Replace with actual Beneficiary ID\nconst beneficiaryId = \"your_beneficiary_id\";\nasync function getBeneficiaryDetails() {\n try {\n const response = await axios.get(\n `${baseUrl}/beneficiary/details/${beneficiaryId}`,\n {\n headers: {\n \"Authorization\": `Bearer ${sessionToken}`\n }\n }\n );\n console.log(\"Beneficiary Details:\", response.data);\n } catch (error) {\n console.error(\n \"Error fetching beneficiary details:\",\n error.response?.data || error.message\n );\n }\n}\ngetBeneficiaryDetails();\n\n{\n \"ResponseCode\": 200,\n \"ResponseMessage\": \"Success\",\n \"ResponseData\": {\n \"CreatedBy\": \"Zomato - Rishav\",\n \"CreatedOn\": \"2025-07-10T09:05:16.431-04:00\",\n \"BeneficiaryId\": \"-1654055480350822652\",\n \"Available_Payments_Type\": [],\n \"Beneficiary_Type\": \"Individual\",\n \"Beneficiary_Name\": \"Varun 1 Upadhayay 2\",\n \"Beneficiary_First_Name\": \"Varun 1\",\n \"Beneficiary_Last_Name\": \"Upadhayay 2\",\n \"Beneficiary_Email\": \"varun+1@mailinator.com\",\n \"Beneficiary_Status\": \"Active\",\n \"ID_Document\": \"Beneficiary ID Document (-1649551880723452156)\",\n \"Beneficiary_Country\": \"India\",\n \"Beneficiary_State\": \"UP\",\n \"Beneficiary_City\": \"Agra\",\n \"Beneficiary_Address\": \"1437 VIP Road\",\n \"Beneficiary_Postal_Code\": \"282001\",\n \"Virtual_Account\": {\n \"Account_Number\": \"780008000074\",\n \"Deposit_Instructions\": [\n {\n \"Title\": \"Domestic Wire Deposit\",\n \"Type\": \"Domestic Wire\",\n \"Note\": \"Domestic Wire - Please use these instructions for any wires within the United States. You will need to provide this information to the bank that is sending the wire to your FV Bank Account. You must provide the Reference for your FV Bank account in the Reference/Memo Field.\",\n \"Receiving Bank Name\": \"Cornerstone Capital Bank\",\n \"Receiving Bank Address\": \"1177 West Loop South, Suite 700, Houston, TX 77027\",\n \"Routing Number/ABA\": \"111326275\",\n \"Beneficiary Name\": \"FV Bank International Inc.\",\n \"Beneficiary Address\": \"270 MuΓ±oz Rivera Avenue, Suite 1120, San Juan, PR 00918\",\n \"Beneficiary Account Number\": \"100107427\",\n \"Reference/Memo #\": \"780008000074\",\n \"Gateway\": \"cornerstone\"\n },\n {\n \"Title\": \"USDC Stablecoin Deposit\",\n \"Type\": \"USDC Stablecoin\",\n \"Note\": \"Deposits must be transferred on the ETH Blockchain. Any asset other than USDC sent to this address will not reach FV Bank and will be lost. Lost transfers may not be recoverable.\",\n \"Deposit Address\": \"Deposit Address request was successful. Your Deposit Address will be available shortly!\",\n \"Currency\": \"USDC\",\n \"Stablecoin Network\": \"ETH\"\n }\n ]\n }\n }\n}\n\nShare deposit instructions with your beneficiary
\nBeneficiary sends funds to assigned virtual account
\nFVBank creates a deposit transaction
\nTransaction webhook includes:
\n{\n \"label\": \"Virtual Account\",\n \"value\": \"780008000006\"\n}\n\nIn deposit webhooks, the Virtual Account field is included in AdditionalData.
This allows you to:
\nIdentify which beneficiary the deposit belongs to
\nAutomatically reconcile funds
\nAvoid manual mapping
\nAlways store Beneficiary ID β Virtual Account mapping
\nUse webhooks for real-time deposit tracking
\nValidate documents (Front_Document, Back_Document) before submission, refer to upload file endpoint to understand how to upload file for these fields
Create Beneficiary (with VA) β Get Deposit Instructions β Share with User β Receive Deposit β Map via Virtual Account\n\nVirtual Accounts enable automated, scalable, and error-free deposit reconciliation.
\n","_postman_id":"205f2136-21c9-4cca-9b8b-ca9ab1c4f896"}],"id":"eab74589-6714-4c01-b363-8db0616e06b7","description":"The following use cases demonstrate common workflows that can be implemented using FV Merchant APIs. Each use case is designed to guide you through a complete, real-world flow rather than isolated API calls.
\nAll outbound transactionsβwhether bank payments or stablecoin transfersβfollow a consistent pattern:
\nCreate Beneficiary β Add Payment Instrument β Initiate Payment β Track Transaction\n\n1. Beneficiary
A beneficiary represents the recipient of funds. This can be an individual or a business entity.
2. Payment Instrument
A payment instrument defines how funds are delivered to the beneficiary. Examples include:
Bank accounts (ACH, Wire, SEPA)
\nBlockchain wallet addresses (USDC, PYUSD)
\n3. Payment
A payment is created using a selected payment instrument to transfer funds to the beneficiary.
A single beneficiary can have multiple payment instruments
\nEach payment instrument must be unique and non-identical
\nPayment instruments can be of different types (e.g., ACH + Wire + Crypto wallet)
\nBeneficiary\n βββ Bank Account (ACH)\n βββ Bank Account (Wire)\n βββ Crypto Wallet (USDC)\n\nEach use case in this section builds on the flow above and demonstrates:
\nRequired API calls
\nExample request/response payloads
\nHow IDs flow between steps
\nBest practices for handling payments
\nStart with the use case most relevant to your integration (e.g., Send Bank Payments or Send Stablecoin Payments) and follow the steps sequentially.
\nThese use cases are designed to help you integrate faster by focusing on end-to-end workflows rather than individual endpoints.
\n","_postman_id":"eab74589-6714-4c01-b363-8db0616e06b7"},{"name":"π API Reference","item":[{"name":"Auth","item":[{"name":"Get Session Token","event":[{"listen":"prerequest","script":{"id":"398b1175-f681-4a6e-b5e1-edf25dd5d919","exec":["// JWT generation script adapted from","// https://gist.github.com/corbanb/db03150abbe899285d6a86cc480f674d","","var jwtSecret = pm.environment.get('clientSecret') || ''","","// Set headers for JWT","var header = {","\t'typ': 'JWT',","\t'alg': 'HS256'","};","","// Prepare timestamp in seconds","var currentTimestamp = Math.floor(Date.now() / 1000)","","var data = {"," 'ClientID': pm.environment.get('clientID'),","\t'iat': currentTimestamp,","\t'exp': currentTimestamp + 30, // expiry time is 30 seconds from time of creation","}","","function base64url(source) {"," // Encode in classical base64"," encodedSource = CryptoJS.enc.Base64.stringify(source)"," "," // Remove padding equal characters"," encodedSource = encodedSource.replace(/=+$/, '')"," "," // Replace characters according to base64url specifications"," encodedSource = encodedSource.replace(/\\+/g, '-')"," encodedSource = encodedSource.replace(/\\//g, '_')"," "," return encodedSource","}","","// encode header","var stringifiedHeader = CryptoJS.enc.Utf8.parse(JSON.stringify(header))","var encodedHeader = base64url(stringifiedHeader)","","// encode data","var stringifiedData = CryptoJS.enc.Utf8.parse(JSON.stringify(data))","var encodedData = base64url(stringifiedData)","","// build token","var token = `${encodedHeader}.${encodedData}`","","// sign token","var signature = CryptoJS.HmacSHA256(token, jwtSecret)","signature = base64url(signature)","var signedToken = `${token}.${signature}`","","pm.environment.set('authToken', signedToken)","console.log('Signed and encoded JWT', signedToken)"],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"test","script":{"id":"dafe3b44-3733-4132-91a1-d39e347e7329","exec":["var jsonData = pm.response.json();","pm.environment.set(\"sessionToken\", jsonData.ResponseData.SessionToken);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"3006c58f-9e35-4b14-b798-f5fa3f7bcc1a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"X-AUTH-TOKEN","value":"{{authToken}}","type":"text"}],"url":"{{baseURL}}/v2/auth","description":"To get the SessionToken that is to be used in all other endpoints. This endpoint requires a header named AUTH-TOKEN which expected to be a JWT token of the below payload signed with the client secret that is shared by the FV Bank Team.
P.S AUTH-TOKEN is changed to X-AUTH-TOKEN. The former one is deprecated and removed.
{\n \"ClientID\": \"YOUR_CLIENT_ID\",\n \"iat\": CURRENT_TIMESTAMP,\n \"exp\":CURRENT_TIMESTAMP + 30 \\* 60 \\* 60 \\* 24\n}\n\nNote: HS256 is the algorithm to be used while generating JWT.
SessionToken returned from the API is valid for 15 minutes.
The x-refresh-token header will be present in the other endpoints before 2 minutes of the current token expiry, the same can be replaced with existing one.
Note that calls to the secured endpoints requires the same IP address that was used to obtain the session token.
\n","urlObject":{"path":["v2","auth"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[{"id":"24de6ada-620a-4bde-9dd3-bb60fd6c6f0b","name":"Get Session Token","originalRequest":{"method":"GET","header":[{"key":"X-AUTH-TOKEN","value":"{{authToken}}","type":"text"}],"url":"{{baseURL}}/auth"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"x-powered-by","value":"Express"},{"key":"content-security-policy","value":"default-src 'self';base-uri 'self';block-all-mixed-content;font-src 'self' https: data:;frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests"},{"key":"x-dns-prefetch-control","value":"off"},{"key":"expect-ct","value":"max-age=0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains"},{"key":"x-download-options","value":"noopen"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-permitted-cross-domain-policies","value":"none"},{"key":"referrer-policy","value":"no-referrer"},{"key":"x-xss-protection","value":"0"},{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"content-length","value":"278"},{"key":"etag","value":"W/\"116-wryw7XWU88NWapM89RrHdfosafE\""},{"key":"x-execution-time","value":"143"},{"key":"vary","value":"Accept-Encoding, Authorization, Cookie"},{"key":"date","value":"Thu, 25 Nov 2021 10:41:22 GMT"},{"key":"connection","value":"keep-alive"},{"key":"keep-alive","value":"timeout=5"},{"key":"cache-control","value":"private"}],"cookie":[],"responseTime":null,"body":"{\n \"ResponseCode\": 200,\n \"ResponseMessage\": \"Success\",\n \"ResponseData\": {\n \"SessionToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJDbGllbnRJRCI6ImRlY2EzNWZkLTMzMGItNDA2My04ZmRhLWZjMGQxYjYxMDcyYyIsImlhdCI6MTYzNzgzNjg4MiwiZXhwIjoxNjM3ODM3NzgyfQ.9c97iKdf-IAdvVz7O_QvjB-zL7e4OQAEukBCD3qXIa8\"\n }\n}"},{"id":"77c8c2c4-578f-4f3e-a51f-250f9830ca14","name":"Get Session Token - Incorrect Token","originalRequest":{"method":"GET","header":[{"key":"X-AUTH-TOKEN","value":"fsdfdsfsdf.asfsadfasdfsda.asfasdfasdfsdf","type":"text"}],"url":"{{baseURL}}/auth"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"x-powered-by","value":"Express"},{"key":"content-security-policy","value":"default-src 'self';base-uri 'self';block-all-mixed-content;font-src 'self' https: data:;frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests"},{"key":"x-dns-prefetch-control","value":"off"},{"key":"expect-ct","value":"max-age=0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains"},{"key":"x-download-options","value":"noopen"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-permitted-cross-domain-policies","value":"none"},{"key":"referrer-policy","value":"no-referrer"},{"key":"x-xss-protection","value":"0"},{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"content-length","value":"106"},{"key":"etag","value":"W/\"6a-C4LASMCPnCyFHADljvpEV/Iba3c\""},{"key":"x-execution-time","value":"14"},{"key":"vary","value":"Accept-Encoding, Authorization, Cookie"},{"key":"date","value":"Wed, 01 Dec 2021 05:50:30 GMT"},{"key":"connection","value":"keep-alive"},{"key":"keep-alive","value":"timeout=5"},{"key":"cache-control","value":"private"}],"cookie":[],"responseTime":null,"body":"{\n \"ResponseCode\": 400,\n \"ResponseMessage\": \"BadRequest\",\n \"ResponseErrors\": [\n \"headers[auth-token]: Bad Request.\"\n ]\n}"}],"_postman_id":"3006c58f-9e35-4b14-b798-f5fa3f7bcc1a"}],"id":"d9fff990-ae80-4639-b412-1b9b6079f2d2","_postman_id":"d9fff990-ae80-4639-b412-1b9b6079f2d2","description":""},{"name":"Accounts","item":[{"name":"Get Account Balance","id":"bdbdf2e9-57f3-455b-bfa8-d04bfd495ff3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{baseURL}}/v2/account/balance","description":"To get the account balance of the client. While the API returns all three types of balances (balance, reserved, available) for the merchant partner, it is advised to check against the availableBalance before performing any transactions.
\nReserved balance - Several transactions needs authorizations from the bank / the payer. Amounts of such transactions get added in the reserved balance.
\nAvailable balance - Balance that can considered before performing any transactions.
\nBalance - Total balance on the account which is the sum of reserved, and available balances.
\nTo get the deposit instructions for the client
\nThis endpoint provides the list of fields that are needed in the Create Beneficiary endpoint.
\nIn-order to make transfer it is required to create the beneficiary first. This endpoint creates the beneficiary. Please refer to the examples for creatiing beneficiary with or without virtual account associated with it
\nNote: A virtual account will be created if you include the 'Beneficiary_Document' field in the request body and the Virtual Account service is activated for your account.
\nNote: Use Get Bank Details endpoint to fetch beneficiary bank details using routing number.
\nVirtual accounts are a solution that enables account holders to generate unique account numbers for receiving third-party deposits while maintaining centralized fund management. Each virtual account is linked to a specific beneficiary relationshipβwhether a vendor or customerβand comes with dedicated deposit instructions accessible through web portals, mobile applications, and APIs. When funds are deposited using a virtual account reference, the system automatically routes these payments to the parent account holder's primary USD bank account. This creates a seamless collection mechanism for multiple payment sources without the complexity of managing separate physical bank accounts.
\nThis endpoint takes in the beneficiary type and returns all the fields required to add a virtual account to an already existing beneficiary
\nNote: Please refer to attached examples for the exact values
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{sessionToken}}"}]},"isInherited":true,"source":{"_postman_id":"d011a139-497a-4023-810f-e855a2b6cbb1","id":"d011a139-497a-4023-810f-e855a2b6cbb1","name":"Beneficiary","type":"folder"}},"urlObject":{"path":["v2","beneficiary","get-required-fields-for-virtual-account"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[{"id":"9bd983df-4e12-40ca-a1a8-f8f343c3d419","name":"Get Required Fields [V2] - Individual","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"BeneficiaryType\": \"individual\"\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/v2/beneficiary/get-required-fields"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"private"},{"key":"Content-Encoding","value":"gzip"},{"key":"Content-Security-Policy","value":"default-src 'self';base-uri 'self';block-all-mixed-content;font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Cross-Origin-Embedder-Policy","value":"require-corp"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Etag","value":"W/\"1b26-Nx26u7EH3plLXYVjZZ738F95ZIE\""},{"key":"Expect-Ct","value":"max-age=0"},{"key":"Function-Execution-Id","value":"a336r8bibu7i"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Server","value":"Google Frontend"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Cloud-Trace-Context","value":"360ae44c07184b0cfd0d3dce9aef2c22;o=1"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Country-Code","value":"IN"},{"key":"X-Dns-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Execution-Time","value":"1156"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-Powered-By","value":"Express"},{"key":"X-Xss-Protection","value":"0"},{"key":"Accept-Ranges","value":"bytes"},{"key":"Date","value":"Sun, 29 Jan 2023 13:13:18 GMT"},{"key":"X-Served-By","value":"cache-maa10221-MAA"},{"key":"X-Cache","value":"MISS"},{"key":"X-Cache-Hits","value":"0"},{"key":"X-Timer","value":"S1674997997.241653,VS0,VE1446"},{"key":"Vary","value":"Accept-Encoding,cookie,need-authorization, x-fh-requested-host, accept-encoding"},{"key":"alt-svc","value":"h3=\":443\";ma=86400,h3-29=\":443\";ma=86400,h3-27=\":443\";ma=86400"},{"key":"transfer-encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"ResponseCode\": 200,\n \"ResponseMessage\": \"Success\",\n \"ResponseData\": {\n \"Fields\": [\n {\n \"Name\": \"Beneficiary_Type\",\n \"Required\": true,\n \"Type\": \"Text\",\n \"PossibleValues\": [\n {\n \"label\": \"Individual\",\n \"value\": \"individual\"\n },\n {\n \"label\": \"Business\",\n \"value\": \"business\"\n }\n ]\n },\n {\n \"Name\": \"Beneficiary_Name\",\n \"Required\": false,\n \"Type\": \"Text\"\n },\n {\n \"Name\": \"Beneficiary_First_Name\",\n \"Required\": true,\n \"Type\": \"Text\"\n },\n {\n \"Name\": \"Beneficiary_Last_Name\",\n \"Required\": true,\n \"Type\": \"Text\"\n },\n {\n \"Name\": \"Beneficiary_Email\",\n \"Required\": false,\n \"Type\": \"Text\"\n },\n {\n \"Name\": \"Beneficiary_Payment_Type\",\n \"Required\": false,\n \"Type\": \"Text\",\n \"PossibleValues\": [\n {\n \"label\": \"Payment - Domestic (ACH)\",\n \"value\": \"BUS_USD_Account.Business_ACH\"\n },\n {\n \"label\": \"Payment - Domestic Wire\",\n \"value\": \"BUS_USD_Account.Domestic_Wire_BUS\"\n },\n {\n \"label\": \"Payment - International Wire\",\n \"value\": \"BUS_USD_Account.BUS_International_Transfer\"\n }\n ]\n },\n {\n \"Name\": \"Beneficiary_Address\",\n \"Required\": true,\n \"Type\": \"Text\"\n },\n {\n \"Name\": \"Beneficiary_City\",\n \"Required\": true,\n \"Type\": \"Text\"\n },\n {\n \"Name\": \"Beneficiary_Postal_Code\",\n \"Required\": true,\n \"Type\": \"Text\"\n },\n {\n \"Name\": \"Beneficiary_Country\",\n \"Required\": true,\n \"Type\": \"Text\",\n \"PossibleValues\": [\n {\n \"label\": \"Albania\",\n \"value\": \"AL\"\n },\n {\n \"label\": \"Algeria\",\n \"value\": \"DZ\"\n },\n {\n \"label\": \"American Samoa\",\n \"value\": \"AS\"\n },\n {\n \"label\": \"Andorra\",\n \"value\": \"AD\"\n },\n {\n \"label\": \"Anguilla\",\n \"value\": \"AI\"\n },\n {\n \"label\": \"Antarctica\",\n \"value\": \"AQ\"\n },\n {\n \"label\": \"Antigua and Barbuda\",\n \"value\": \"AG\"\n },\n {\n \"label\": \"Argentina\",\n \"value\": \"AR\"\n },\n {\n \"label\": \"Armenia\",\n \"value\": \"AM\"\n },\n {\n \"label\": \"Aruba\",\n \"value\": \"AW\"\n },\n {\n \"label\": \"Australia\",\n \"value\": \"AU\"\n },\n {\n \"label\": \"Austria\",\n \"value\": \"AT\"\n },\n {\n \"label\": \"Azerbaijan\",\n \"value\": \"AZ\"\n },\n {\n \"label\": \"Bahamas\",\n \"value\": \"BS\"\n },\n {\n \"label\": \"Bangladesh\",\n \"value\": \"BD\"\n },\n {\n \"label\": \"Barbados\",\n \"value\": \"BB\"\n },\n {\n \"label\": \"Belgium\",\n \"value\": \"BE\"\n },\n {\n \"label\": \"Belize\",\n \"value\": \"BZ\"\n },\n {\n \"label\": \"Bermuda\",\n \"value\": \"BM\"\n },\n {\n \"label\": \"Bolivia (Plurinational State of)\",\n \"value\": \"BO\"\n },\n {\n \"label\": \"Bosnia and Herzegovina\",\n \"value\": \"BA\"\n },\n {\n \"label\": \"Brazil\",\n \"value\": \"BR\"\n },\n {\n \"label\": \"British Indian Ocean Territory\",\n \"value\": \"IO\"\n },\n {\n \"label\": \"United States Minor Outlying Islands\",\n \"value\": \"UM\"\n },\n {\n \"label\": \"Virgin Islands (British)\",\n \"value\": \"VG\"\n },\n {\n \"label\": \"Virgin Islands (U.S.)\",\n \"value\": \"VI\"\n },\n {\n \"label\": \"Brunei Darussalam\",\n \"value\": \"BN\"\n },\n {\n \"label\": \"Bulgaria\",\n \"value\": \"BG\"\n },\n {\n \"label\": \"Cambodia\",\n \"value\": \"KH\"\n },\n {\n \"label\": \"Cameroon\",\n \"value\": \"CM\"\n },\n {\n \"label\": \"Canada\",\n \"value\": \"CA\"\n },\n {\n \"label\": \"Cayman Islands\",\n \"value\": \"KY\"\n },\n {\n \"label\": \"Chile\",\n \"value\": \"CL\"\n },\n {\n \"label\": \"China\",\n \"value\": \"CN\"\n },\n {\n \"label\": \"Colombia\",\n \"value\": \"CO\"\n },\n {\n \"label\": \"Comoros\",\n \"value\": \"KM\"\n },\n {\n \"label\": \"Cook Islands\",\n \"value\": \"CK\"\n },\n {\n \"label\": \"Costa Rica\",\n \"value\": \"CR\"\n },\n {\n \"label\": \"Croatia\",\n \"value\": \"HR\"\n },\n {\n \"label\": \"CuraΓΒ§ao\",\n \"value\": \"CW\"\n },\n {\n \"label\": \"Cyprus\",\n \"value\": \"CY\"\n },\n {\n \"label\": \"Czech Republic\",\n \"value\": \"CZ\"\n },\n {\n \"label\": \"Denmark\",\n \"value\": \"DK\"\n },\n {\n \"label\": \"Dominica\",\n \"value\": \"DM\"\n },\n {\n \"label\": \"Dominican Republic\",\n \"value\": \"DO\"\n },\n {\n \"label\": \"Ecuador\",\n \"value\": \"EC\"\n },\n {\n \"label\": \"Egypt\",\n \"value\": \"EG\"\n },\n {\n \"label\": \"El Salvador\",\n \"value\": \"SV\"\n },\n {\n \"label\": \"Estonia\",\n \"value\": \"EE\"\n },\n {\n \"label\": \"Falkland Islands (Malvinas)\",\n \"value\": \"FK\"\n },\n {\n \"label\": \"Fiji\",\n \"value\": \"FJ\"\n },\n {\n \"label\": \"Finland\",\n \"value\": \"FI\"\n },\n {\n \"label\": \"France\",\n \"value\": \"FR\"\n },\n {\n \"label\": \"French Guiana\",\n \"value\": \"GF\"\n },\n {\n \"label\": \"French Polynesia\",\n \"value\": \"PF\"\n },\n {\n \"label\": \"Gambia\",\n \"value\": \"GM\"\n },\n {\n \"label\": \"Georgia\",\n \"value\": \"GE\"\n },\n {\n \"label\": \"Germany\",\n \"value\": \"DE\"\n },\n {\n \"label\": \"Ghana\",\n \"value\": \"GH\"\n },\n {\n \"label\": \"Gibraltar\",\n \"value\": \"GI\"\n },\n {\n \"label\": \"Greece\",\n \"value\": \"GR\"\n },\n {\n \"label\": \"Greenland\",\n \"value\": \"GL\"\n },\n {\n \"label\": \"Grenada\",\n \"value\": \"GD\"\n },\n {\n \"label\": \"Guadeloupe\",\n \"value\": \"GP\"\n },\n {\n \"label\": \"Guam\",\n \"value\": \"GU\"\n },\n {\n \"label\": \"Guatemala\",\n \"value\": \"GT\"\n },\n {\n \"label\": \"Guernsey\",\n \"value\": \"GG\"\n },\n {\n \"label\": \"Honduras\",\n \"value\": \"HN\"\n },\n {\n \"label\": \"Hong Kong\",\n \"value\": \"HK\"\n },\n {\n \"label\": \"Hungary\",\n \"value\": \"HU\"\n },\n {\n \"label\": \"Iceland\",\n \"value\": \"IS\"\n },\n {\n \"label\": \"India\",\n \"value\": \"IN\"\n },\n {\n \"label\": \"Indonesia\",\n \"value\": \"ID\"\n },\n {\n \"label\": \"Ireland\",\n \"value\": \"IE\"\n },\n {\n \"label\": \"Isle of Man\",\n \"value\": \"IM\"\n },\n {\n \"label\": \"Israel\",\n \"value\": \"IL\"\n },\n {\n \"label\": \"Italy\",\n \"value\": \"IT\"\n },\n {\n \"label\": \"Jamaica\",\n \"value\": \"JM\"\n },\n {\n \"label\": \"Japan\",\n \"value\": \"JP\"\n },\n {\n \"label\": \"Jersey\",\n \"value\": \"JE\"\n },\n {\n \"label\": \"Jordan\",\n \"value\": \"JO\"\n },\n {\n \"label\": \"Kazakhstan\",\n \"value\": \"KZ\"\n },\n {\n \"label\": \"Kenya\",\n \"value\": \"KE\"\n },\n {\n \"label\": \"Kuwait\",\n \"value\": \"KW\"\n },\n {\n \"label\": \"Kyrgyzstan\",\n \"value\": \"KG\"\n },\n {\n \"label\": \"Lao People's Democratic Republic\",\n \"value\": \"LA\"\n },\n {\n \"label\": \"Latvia\",\n \"value\": \"LV\"\n },\n {\n \"label\": \"Liechtenstein\",\n \"value\": \"LI\"\n },\n {\n \"label\": \"Lithuania\",\n \"value\": \"LT\"\n },\n {\n \"label\": \"Luxembourg\",\n \"value\": \"LU\"\n },\n {\n \"label\": \"Macao\",\n \"value\": \"MO\"\n },\n {\n \"label\": \"Macedonia (the former Yugoslav Republic of)\",\n \"value\": \"MK\"\n },\n {\n \"label\": \"Madagascar\",\n \"value\": \"MG\"\n },\n {\n \"label\": \"Malaysia\",\n \"value\": \"MY\"\n },\n {\n \"label\": \"Maldives\",\n \"value\": \"MV\"\n },\n {\n \"label\": \"Mali\",\n \"value\": \"ML\"\n },\n {\n \"label\": \"Malta\",\n \"value\": \"MT\"\n },\n {\n \"label\": \"Marshall Islands\",\n \"value\": \"MH\"\n },\n {\n \"label\": \"Martinique\",\n \"value\": \"MQ\"\n },\n {\n \"label\": \"Mauritania\",\n \"value\": \"MR\"\n },\n {\n \"label\": \"Mauritius\",\n \"value\": \"MU\"\n },\n {\n \"label\": \"Mexico\",\n \"value\": \"MX\"\n },\n {\n \"label\": \"Moldova (Republic of)\",\n \"value\": \"MD\"\n },\n {\n \"label\": \"Monaco\",\n \"value\": \"MC\"\n },\n {\n \"label\": \"Mongolia\",\n \"value\": \"MN\"\n },\n {\n \"label\": \"Montenegro\",\n \"value\": \"ME\"\n },\n {\n \"label\": \"Montserrat\",\n \"value\": \"MS\"\n },\n {\n \"label\": \"Morocco\",\n \"value\": \"MA\"\n },\n {\n \"label\": \"Nepal\",\n \"value\": \"NP\"\n },\n {\n \"label\": \"Netherlands\",\n \"value\": \"NL\"\n },\n {\n \"label\": \"New Zealand\",\n \"value\": \"NZ\"\n },\n {\n \"label\": \"Nigeria\",\n \"value\": \"NG\"\n },\n {\n \"label\": \"Norway\",\n \"value\": \"NO\"\n },\n {\n \"label\": \"Oman\",\n \"value\": \"OM\"\n },\n {\n \"label\": \"Pakistan\",\n \"value\": \"PK\"\n },\n {\n \"label\": \"Panama\",\n \"value\": \"PA\"\n },\n {\n \"label\": \"Paraguay\",\n \"value\": \"PY\"\n },\n {\n \"label\": \"Peru\",\n \"value\": \"PE\"\n },\n {\n \"label\": \"Philippines\",\n \"value\": \"PH\"\n },\n {\n \"label\": \"Poland\",\n \"value\": \"PL\"\n },\n {\n \"label\": \"Portugal\",\n \"value\": \"PT\"\n },\n {\n \"label\": \"Puerto Rico\",\n \"value\": \"PR\"\n },\n {\n \"label\": \"Qatar\",\n \"value\": \"QA\"\n },\n {\n \"label\": \"Republic of Kosovo\",\n \"value\": \"XK\"\n },\n {\n \"label\": \"Romania\",\n \"value\": \"RO\"\n },\n {\n \"label\": \"Russian Federation\",\n \"value\": \"RU\"\n },\n {\n \"label\": \"Saint Kitts and Nevis\",\n \"value\": \"KN\"\n },\n {\n \"label\": \"Saint Lucia\",\n \"value\": \"LC\"\n },\n {\n \"label\": \"Saint Martin (French part)\",\n \"value\": \"MF\"\n },\n {\n \"label\": \"Saint Vincent and the Grenadines\",\n \"value\": \"VC\"\n },\n {\n \"label\": \"Samoa\",\n \"value\": \"WS\"\n },\n {\n \"label\": \"San Marino\",\n \"value\": \"SM\"\n },\n {\n \"label\": \"Saudi Arabia\",\n \"value\": \"SA\"\n },\n {\n \"label\": \"Serbia\",\n \"value\": \"RS\"\n },\n {\n \"label\": \"Seychelles\",\n \"value\": \"SC\"\n },\n {\n \"label\": \"Sierra Leone\",\n \"value\": \"SL\"\n },\n {\n \"label\": \"Singapore\",\n \"value\": \"SG\"\n },\n {\n \"label\": \"Slovakia\",\n \"value\": \"SK\"\n },\n {\n \"label\": \"Slovenia\",\n \"value\": \"SI\"\n },\n {\n \"label\": \"South Africa\",\n \"value\": \"ZA\"\n },\n {\n \"label\": \"Korea\",\n \"value\": \"KR\"\n },\n {\n \"label\": \"South Sudan\",\n \"value\": \"SS\"\n },\n {\n \"label\": \"Spain\",\n \"value\": \"ES\"\n },\n {\n \"label\": \"Sweden\",\n \"value\": \"SE\"\n },\n {\n \"label\": \"Switzerland\",\n \"value\": \"CH\"\n },\n {\n \"label\": \"Taiwan\",\n \"value\": \"TW\"\n },\n {\n \"label\": \"Tajikistan\",\n \"value\": \"TJ\"\n },\n {\n \"label\": \"Tanzania, United Republic of\",\n \"value\": \"TZ\"\n },\n {\n \"label\": \"Thailand\",\n \"value\": \"TH\"\n },\n {\n \"label\": \"Trinidad and Tobago\",\n \"value\": \"TT\"\n },\n {\n \"label\": \"Tunisia\",\n \"value\": \"TN\"\n },\n {\n \"label\": \"Turkey\",\n \"value\": \"TR\"\n },\n {\n \"label\": \"Turkmenistan\",\n \"value\": \"TM\"\n },\n {\n \"label\": \"Turks and Caicos Islands\",\n \"value\": \"TC\"\n },\n {\n \"label\": \"United Arab Emirates\",\n \"value\": \"AE\"\n },\n {\n \"label\": \"United Kingdom\",\n \"value\": \"GB\"\n },\n {\n \"label\": \"United States of America\",\n \"value\": \"US\"\n },\n {\n \"label\": \"Uruguay\",\n \"value\": \"UY\"\n },\n {\n \"label\": \"Uzbekistan\",\n \"value\": \"UZ\"\n },\n {\n \"label\": \"Vanuatu\",\n \"value\": \"VU\"\n },\n {\n \"label\": \"Vietnam\",\n \"value\": \"VN\"\n }\n ]\n }\n ]\n }\n}"},{"id":"728fb41f-2771-49ab-b1e6-89be47bedb1e","name":"Get Required Fields [V2] - Business","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"BeneficiaryType\": \"business\"\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/v2/beneficiary/get-required-fields"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"private"},{"key":"Content-Encoding","value":"gzip"},{"key":"Content-Security-Policy","value":"default-src 'self';base-uri 'self';block-all-mixed-content;font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Cross-Origin-Embedder-Policy","value":"require-corp"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Etag","value":"W/\"1ae9-BxNl+QB1/j2qy+Kx/6uEtnKWXJs\""},{"key":"Expect-Ct","value":"max-age=0"},{"key":"Function-Execution-Id","value":"a33680h00m10"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Server","value":"Google Frontend"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Cloud-Trace-Context","value":"ff5c147a4f24c99a600c504f7cdc7f5f"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Country-Code","value":"IN"},{"key":"X-Dns-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Execution-Time","value":"659"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-Powered-By","value":"Express"},{"key":"X-Xss-Protection","value":"0"},{"key":"Accept-Ranges","value":"bytes"},{"key":"Date","value":"Sun, 29 Jan 2023 13:14:21 GMT"},{"key":"X-Served-By","value":"cache-maa10221-MAA"},{"key":"X-Cache","value":"MISS"},{"key":"X-Cache-Hits","value":"0"},{"key":"X-Timer","value":"S1674998061.574460,VS0,VE943"},{"key":"Vary","value":"Accept-Encoding,cookie,need-authorization, x-fh-requested-host, accept-encoding"},{"key":"alt-svc","value":"h3=\":443\";ma=86400,h3-29=\":443\";ma=86400,h3-27=\":443\";ma=86400"},{"key":"transfer-encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"ResponseCode\": 200,\n \"ResponseMessage\": \"Success\",\n \"ResponseData\": {\n \"Fields\": [\n {\n \"Name\": \"Beneficiary_Type\",\n \"Required\": true,\n \"Type\": \"Text\",\n \"PossibleValues\": [\n {\n \"label\": \"Individual\",\n \"value\": \"individual\"\n },\n {\n \"label\": \"Business\",\n \"value\": \"business\"\n }\n ]\n },\n {\n \"Name\": \"Beneficiary_Name\",\n \"Required\": false,\n \"Type\": \"Text\"\n },\n {\n \"Name\": \"Beneficiary_Company_Name\",\n \"Required\": true,\n \"Type\": \"Text\"\n },\n {\n \"Name\": \"Beneficiary_Email\",\n \"Required\": false,\n \"Type\": \"Text\"\n },\n {\n \"Name\": \"Beneficiary_Payment_Type\",\n \"Required\": false,\n \"Type\": \"Text\",\n \"PossibleValues\": [\n {\n \"label\": \"Payment - Domestic (ACH)\",\n \"value\": \"BUS_USD_Account.Business_ACH\"\n },\n {\n \"label\": \"Payment - Domestic Wire\",\n \"value\": \"BUS_USD_Account.Domestic_Wire_BUS\"\n },\n {\n \"label\": \"Payment - International Wire\",\n \"value\": \"BUS_USD_Account.BUS_International_Transfer\"\n }\n ]\n },\n {\n \"Name\": \"Beneficiary_Address\",\n \"Required\": true,\n \"Type\": \"Text\"\n },\n {\n \"Name\": \"Beneficiary_City\",\n \"Required\": true,\n \"Type\": \"Text\"\n },\n {\n \"Name\": \"Beneficiary_Postal_Code\",\n \"Required\": true,\n \"Type\": \"Text\"\n },\n {\n \"Name\": \"Beneficiary_Country\",\n \"Required\": true,\n \"Type\": \"Text\",\n \"PossibleValues\": [\n {\n \"label\": \"Albania\",\n \"value\": \"AL\"\n },\n {\n \"label\": \"Algeria\",\n \"value\": \"DZ\"\n },\n {\n \"label\": \"American Samoa\",\n \"value\": \"AS\"\n },\n {\n \"label\": \"Andorra\",\n \"value\": \"AD\"\n },\n {\n \"label\": \"Anguilla\",\n \"value\": \"AI\"\n },\n {\n \"label\": \"Antarctica\",\n \"value\": \"AQ\"\n },\n {\n \"label\": \"Antigua and Barbuda\",\n \"value\": \"AG\"\n },\n {\n \"label\": \"Argentina\",\n \"value\": \"AR\"\n },\n {\n \"label\": \"Armenia\",\n \"value\": \"AM\"\n },\n {\n \"label\": \"Aruba\",\n \"value\": \"AW\"\n },\n {\n \"label\": \"Australia\",\n \"value\": \"AU\"\n },\n {\n \"label\": \"Austria\",\n \"value\": \"AT\"\n },\n {\n \"label\": \"Azerbaijan\",\n \"value\": \"AZ\"\n },\n {\n \"label\": \"Bahamas\",\n \"value\": \"BS\"\n },\n {\n \"label\": \"Bangladesh\",\n \"value\": \"BD\"\n },\n {\n \"label\": \"Barbados\",\n \"value\": \"BB\"\n },\n {\n \"label\": \"Belgium\",\n \"value\": \"BE\"\n },\n {\n \"label\": \"Belize\",\n \"value\": \"BZ\"\n },\n {\n \"label\": \"Bermuda\",\n \"value\": \"BM\"\n },\n {\n \"label\": \"Bolivia (Plurinational State of)\",\n \"value\": \"BO\"\n },\n {\n \"label\": \"Bosnia and Herzegovina\",\n \"value\": \"BA\"\n },\n {\n \"label\": \"Brazil\",\n \"value\": \"BR\"\n },\n {\n \"label\": \"British Indian Ocean Territory\",\n \"value\": \"IO\"\n },\n {\n \"label\": \"United States Minor Outlying Islands\",\n \"value\": \"UM\"\n },\n {\n \"label\": \"Virgin Islands (British)\",\n \"value\": \"VG\"\n },\n {\n \"label\": \"Virgin Islands (U.S.)\",\n \"value\": \"VI\"\n },\n {\n \"label\": \"Brunei Darussalam\",\n \"value\": \"BN\"\n },\n {\n \"label\": \"Bulgaria\",\n \"value\": \"BG\"\n },\n {\n \"label\": \"Cambodia\",\n \"value\": \"KH\"\n },\n {\n \"label\": \"Cameroon\",\n \"value\": \"CM\"\n },\n {\n \"label\": \"Canada\",\n \"value\": \"CA\"\n },\n {\n \"label\": \"Cayman Islands\",\n \"value\": \"KY\"\n },\n {\n \"label\": \"Chile\",\n \"value\": \"CL\"\n },\n {\n \"label\": \"China\",\n \"value\": \"CN\"\n },\n {\n \"label\": \"Colombia\",\n \"value\": \"CO\"\n },\n {\n \"label\": \"Comoros\",\n \"value\": \"KM\"\n },\n {\n \"label\": \"Cook Islands\",\n \"value\": \"CK\"\n },\n {\n \"label\": \"Costa Rica\",\n \"value\": \"CR\"\n },\n {\n \"label\": \"Croatia\",\n \"value\": \"HR\"\n },\n {\n \"label\": \"CuraΓΒ§ao\",\n \"value\": \"CW\"\n },\n {\n \"label\": \"Cyprus\",\n \"value\": \"CY\"\n },\n {\n \"label\": \"Czech Republic\",\n \"value\": \"CZ\"\n },\n {\n \"label\": \"Denmark\",\n \"value\": \"DK\"\n },\n {\n \"label\": \"Dominica\",\n \"value\": \"DM\"\n },\n {\n \"label\": \"Dominican Republic\",\n \"value\": \"DO\"\n },\n {\n \"label\": \"Ecuador\",\n \"value\": \"EC\"\n },\n {\n \"label\": \"Egypt\",\n \"value\": \"EG\"\n },\n {\n \"label\": \"El Salvador\",\n \"value\": \"SV\"\n },\n {\n \"label\": \"Estonia\",\n \"value\": \"EE\"\n },\n {\n \"label\": \"Falkland Islands (Malvinas)\",\n \"value\": \"FK\"\n },\n {\n \"label\": \"Fiji\",\n \"value\": \"FJ\"\n },\n {\n \"label\": \"Finland\",\n \"value\": \"FI\"\n },\n {\n \"label\": \"France\",\n \"value\": \"FR\"\n },\n {\n \"label\": \"French Guiana\",\n \"value\": \"GF\"\n },\n {\n \"label\": \"French Polynesia\",\n \"value\": \"PF\"\n },\n {\n \"label\": \"Gambia\",\n \"value\": \"GM\"\n },\n {\n \"label\": \"Georgia\",\n \"value\": \"GE\"\n },\n {\n \"label\": \"Germany\",\n \"value\": \"DE\"\n },\n {\n \"label\": \"Ghana\",\n \"value\": \"GH\"\n },\n {\n \"label\": \"Gibraltar\",\n \"value\": \"GI\"\n },\n {\n \"label\": \"Greece\",\n \"value\": \"GR\"\n },\n {\n \"label\": \"Greenland\",\n \"value\": \"GL\"\n },\n {\n \"label\": \"Grenada\",\n \"value\": \"GD\"\n },\n {\n \"label\": \"Guadeloupe\",\n \"value\": \"GP\"\n },\n {\n \"label\": \"Guam\",\n \"value\": \"GU\"\n },\n {\n \"label\": \"Guatemala\",\n \"value\": \"GT\"\n },\n {\n \"label\": \"Guernsey\",\n \"value\": \"GG\"\n },\n {\n \"label\": \"Honduras\",\n \"value\": \"HN\"\n },\n {\n \"label\": \"Hong Kong\",\n \"value\": \"HK\"\n },\n {\n \"label\": \"Hungary\",\n \"value\": \"HU\"\n },\n {\n \"label\": \"Iceland\",\n \"value\": \"IS\"\n },\n {\n \"label\": \"India\",\n \"value\": \"IN\"\n },\n {\n \"label\": \"Indonesia\",\n \"value\": \"ID\"\n },\n {\n \"label\": \"Ireland\",\n \"value\": \"IE\"\n },\n {\n \"label\": \"Isle of Man\",\n \"value\": \"IM\"\n },\n {\n \"label\": \"Israel\",\n \"value\": \"IL\"\n },\n {\n \"label\": \"Italy\",\n \"value\": \"IT\"\n },\n {\n \"label\": \"Jamaica\",\n \"value\": \"JM\"\n },\n {\n \"label\": \"Japan\",\n \"value\": \"JP\"\n },\n {\n \"label\": \"Jersey\",\n \"value\": \"JE\"\n },\n {\n \"label\": \"Jordan\",\n \"value\": \"JO\"\n },\n {\n \"label\": \"Kazakhstan\",\n \"value\": \"KZ\"\n },\n {\n \"label\": \"Kenya\",\n \"value\": \"KE\"\n },\n {\n \"label\": \"Kuwait\",\n \"value\": \"KW\"\n },\n {\n \"label\": \"Kyrgyzstan\",\n \"value\": \"KG\"\n },\n {\n \"label\": \"Lao People's Democratic Republic\",\n \"value\": \"LA\"\n },\n {\n \"label\": \"Latvia\",\n \"value\": \"LV\"\n },\n {\n \"label\": \"Liechtenstein\",\n \"value\": \"LI\"\n },\n {\n \"label\": \"Lithuania\",\n \"value\": \"LT\"\n },\n {\n \"label\": \"Luxembourg\",\n \"value\": \"LU\"\n },\n {\n \"label\": \"Macao\",\n \"value\": \"MO\"\n },\n {\n \"label\": \"Macedonia (the former Yugoslav Republic of)\",\n \"value\": \"MK\"\n },\n {\n \"label\": \"Madagascar\",\n \"value\": \"MG\"\n },\n {\n \"label\": \"Malaysia\",\n \"value\": \"MY\"\n },\n {\n \"label\": \"Maldives\",\n \"value\": \"MV\"\n },\n {\n \"label\": \"Mali\",\n \"value\": \"ML\"\n },\n {\n \"label\": \"Malta\",\n \"value\": \"MT\"\n },\n {\n \"label\": \"Marshall Islands\",\n \"value\": \"MH\"\n },\n {\n \"label\": \"Martinique\",\n \"value\": \"MQ\"\n },\n {\n \"label\": \"Mauritania\",\n \"value\": \"MR\"\n },\n {\n \"label\": \"Mauritius\",\n \"value\": \"MU\"\n },\n {\n \"label\": \"Mexico\",\n \"value\": \"MX\"\n },\n {\n \"label\": \"Moldova (Republic of)\",\n \"value\": \"MD\"\n },\n {\n \"label\": \"Monaco\",\n \"value\": \"MC\"\n },\n {\n \"label\": \"Mongolia\",\n \"value\": \"MN\"\n },\n {\n \"label\": \"Montenegro\",\n \"value\": \"ME\"\n },\n {\n \"label\": \"Montserrat\",\n \"value\": \"MS\"\n },\n {\n \"label\": \"Morocco\",\n \"value\": \"MA\"\n },\n {\n \"label\": \"Nepal\",\n \"value\": \"NP\"\n },\n {\n \"label\": \"Netherlands\",\n \"value\": \"NL\"\n },\n {\n \"label\": \"New Zealand\",\n \"value\": \"NZ\"\n },\n {\n \"label\": \"Nigeria\",\n \"value\": \"NG\"\n },\n {\n \"label\": \"Norway\",\n \"value\": \"NO\"\n },\n {\n \"label\": \"Oman\",\n \"value\": \"OM\"\n },\n {\n \"label\": \"Pakistan\",\n \"value\": \"PK\"\n },\n {\n \"label\": \"Panama\",\n \"value\": \"PA\"\n },\n {\n \"label\": \"Paraguay\",\n \"value\": \"PY\"\n },\n {\n \"label\": \"Peru\",\n \"value\": \"PE\"\n },\n {\n \"label\": \"Philippines\",\n \"value\": \"PH\"\n },\n {\n \"label\": \"Poland\",\n \"value\": \"PL\"\n },\n {\n \"label\": \"Portugal\",\n \"value\": \"PT\"\n },\n {\n \"label\": \"Puerto Rico\",\n \"value\": \"PR\"\n },\n {\n \"label\": \"Qatar\",\n \"value\": \"QA\"\n },\n {\n \"label\": \"Republic of Kosovo\",\n \"value\": \"XK\"\n },\n {\n \"label\": \"Romania\",\n \"value\": \"RO\"\n },\n {\n \"label\": \"Russian Federation\",\n \"value\": \"RU\"\n },\n {\n \"label\": \"Saint Kitts and Nevis\",\n \"value\": \"KN\"\n },\n {\n \"label\": \"Saint Lucia\",\n \"value\": \"LC\"\n },\n {\n \"label\": \"Saint Martin (French part)\",\n \"value\": \"MF\"\n },\n {\n \"label\": \"Saint Vincent and the Grenadines\",\n \"value\": \"VC\"\n },\n {\n \"label\": \"Samoa\",\n \"value\": \"WS\"\n },\n {\n \"label\": \"San Marino\",\n \"value\": \"SM\"\n },\n {\n \"label\": \"Saudi Arabia\",\n \"value\": \"SA\"\n },\n {\n \"label\": \"Serbia\",\n \"value\": \"RS\"\n },\n {\n \"label\": \"Seychelles\",\n \"value\": \"SC\"\n },\n {\n \"label\": \"Sierra Leone\",\n \"value\": \"SL\"\n },\n {\n \"label\": \"Singapore\",\n \"value\": \"SG\"\n },\n {\n \"label\": \"Slovakia\",\n \"value\": \"SK\"\n },\n {\n \"label\": \"Slovenia\",\n \"value\": \"SI\"\n },\n {\n \"label\": \"South Africa\",\n \"value\": \"ZA\"\n },\n {\n \"label\": \"Korea\",\n \"value\": \"KR\"\n },\n {\n \"label\": \"South Sudan\",\n \"value\": \"SS\"\n },\n {\n \"label\": \"Spain\",\n \"value\": \"ES\"\n },\n {\n \"label\": \"Sweden\",\n \"value\": \"SE\"\n },\n {\n \"label\": \"Switzerland\",\n \"value\": \"CH\"\n },\n {\n \"label\": \"Taiwan\",\n \"value\": \"TW\"\n },\n {\n \"label\": \"Tajikistan\",\n \"value\": \"TJ\"\n },\n {\n \"label\": \"Tanzania, United Republic of\",\n \"value\": \"TZ\"\n },\n {\n \"label\": \"Thailand\",\n \"value\": \"TH\"\n },\n {\n \"label\": \"Trinidad and Tobago\",\n \"value\": \"TT\"\n },\n {\n \"label\": \"Tunisia\",\n \"value\": \"TN\"\n },\n {\n \"label\": \"Turkey\",\n \"value\": \"TR\"\n },\n {\n \"label\": \"Turkmenistan\",\n \"value\": \"TM\"\n },\n {\n \"label\": \"Turks and Caicos Islands\",\n \"value\": \"TC\"\n },\n {\n \"label\": \"United Arab Emirates\",\n \"value\": \"AE\"\n },\n {\n \"label\": \"United Kingdom\",\n \"value\": \"GB\"\n },\n {\n \"label\": \"United States of America\",\n \"value\": \"US\"\n },\n {\n \"label\": \"Uruguay\",\n \"value\": \"UY\"\n },\n {\n \"label\": \"Uzbekistan\",\n \"value\": \"UZ\"\n },\n {\n \"label\": \"Vanuatu\",\n \"value\": \"VU\"\n },\n {\n \"label\": \"Vietnam\",\n \"value\": \"VN\"\n }\n ]\n }\n ]\n }\n}"}],"_postman_id":"52c50952-a6fa-438d-be2b-933ddec93c39"},{"name":"Add Virtual Account","event":[{"listen":"test","script":{"id":"bc5ec706-348f-41b0-91c9-2501b536b28f","exec":["var jsonData = pm.response.json();","if(jsonData?.ResponseData?.BeneficiaryId){"," pm.environment.set(\"beneficiaryIDV2\", jsonData.ResponseData.BeneficiaryId);"," }"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"8773b7d4-b2cf-40fd-b56b-3ea903294f74","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"[\n {\n \"field\": \"Beneficiary_Type\",\n \"value\": \"individual\"\n },\n {\n \"field\": \"Beneficiary_DOB\",\n \"value\": \"2001-12-01\"\n },\n {\n \"field\": \"Beneficiary_Document\",\n \"value\": [\n {\n \"field\": \"ID_Type\",\n \"value\": \"Driving_License\"\n },\n {\n \"field\": \"ID_Number\",\n \"value\": \"X12345679\"\n },\n {\n \"field\": \"ID_Expiration_Date\",\n \"value\": \"2027-12-01\"\n },\n {\n \"field\": \"Front_Document\",\n \"value\": \"{{FileId}}\"\n },\n {\n \"field\": \"Back_Document\",\n \"value\": \"7893575729674628909\"\n }\n ]\n }\n]","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/v2/beneficiary/add-virtual-account/{{beneficiaryIDV2}}","description":"This endpoint add a virtual account to an existing beneficiary
\nNote: Please refer to the attached examples for exact values.
\nReturns all the active beneficiaries that are added with the merchant account.
\nTo get the details of a beneficiary.
\nThis endpoint is used to change status of a beneficiary.
\nNote: \"Permission Denied\" message is returned with status code 400 when \"Status\" in request body is same as the beneficiary status.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{sessionToken}}"}]},"isInherited":true,"source":{"_postman_id":"d011a139-497a-4023-810f-e855a2b6cbb1","id":"d011a139-497a-4023-810f-e855a2b6cbb1","name":"Beneficiary","type":"folder"}},"urlObject":{"path":["v2","beneficiary","change-status"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[{"id":"a4a96098-6da8-45ad-a154-876e228e5065","name":"Change Status [Enable]","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":" {\n \"BeneficiaryId\": \"{{beneficiaryIDV2}}\",\n \"Status\": \"Active\"\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/v2/beneficiary/change-status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"x-powered-by","value":"Express"},{"key":"content-security-policy","value":"default-src 'self';base-uri 'self';block-all-mixed-content;font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests"},{"key":"cross-origin-embedder-policy","value":"require-corp"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"cross-origin-resource-policy","value":"same-origin"},{"key":"x-dns-prefetch-control","value":"off"},{"key":"expect-ct","value":"max-age=0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains"},{"key":"x-download-options","value":"noopen"},{"key":"x-content-type-options","value":"nosniff"},{"key":"origin-agent-cluster","value":"?1"},{"key":"x-permitted-cross-domain-policies","value":"none"},{"key":"referrer-policy","value":"no-referrer"},{"key":"x-xss-protection","value":"0"},{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"content-length","value":"125"},{"key":"etag","value":"W/\"7d-ltQTCG9BD7gLU6koSV+BMpZiICo\""},{"key":"x-execution-time","value":"11605"},{"key":"vary","value":"Accept-Encoding, Authorization, Cookie"},{"key":"date","value":"Tue, 10 Jan 2023 07:36:09 GMT"},{"key":"connection","value":"keep-alive"},{"key":"keep-alive","value":"timeout=5"},{"key":"cache-control","value":"private"}],"cookie":[],"responseTime":null,"body":"{\n \"ResponseCode\": 200,\n \"ResponseMessage\": \"Success\",\n \"ResponseData\": \"Beneficiary has been enabled for transactions successfully.\"\n}"},{"id":"83e08018-3e61-4907-883b-b896576af6ef","name":"Change Status [Disable]","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":" {\n \"BeneficiaryId\": \"{{beneficiaryIDV2}}\",\n \"Status\": \"Disable\"\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/v2/beneficiary/change-status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"x-powered-by","value":"Express"},{"key":"content-security-policy","value":"default-src 'self';base-uri 'self';block-all-mixed-content;font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests"},{"key":"cross-origin-embedder-policy","value":"require-corp"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"cross-origin-resource-policy","value":"same-origin"},{"key":"x-dns-prefetch-control","value":"off"},{"key":"expect-ct","value":"max-age=0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains"},{"key":"x-download-options","value":"noopen"},{"key":"x-content-type-options","value":"nosniff"},{"key":"origin-agent-cluster","value":"?1"},{"key":"x-permitted-cross-domain-policies","value":"none"},{"key":"referrer-policy","value":"no-referrer"},{"key":"x-xss-protection","value":"0"},{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"content-length","value":"126"},{"key":"etag","value":"W/\"7e-w6n4xiKyJ+JzIJ/BS7VEB5HXjpg\""},{"key":"x-execution-time","value":"6143"},{"key":"vary","value":"Accept-Encoding, Authorization, Cookie"},{"key":"date","value":"Tue, 10 Jan 2023 07:36:59 GMT"},{"key":"connection","value":"keep-alive"},{"key":"keep-alive","value":"timeout=5"},{"key":"cache-control","value":"private"}],"cookie":[],"responseTime":null,"body":"{\n \"ResponseCode\": 200,\n \"ResponseMessage\": \"Success\",\n \"ResponseData\": \"Beneficiary has been disabled for transactions successfully.\"\n}"}],"_postman_id":"05d4cd0c-68d8-46ce-8ffe-e43b2bb68c65"}],"id":"d011a139-497a-4023-810f-e855a2b6cbb1","description":"In order to initiate a bank transfer, a beneficiary must be added first. This sections consists of endpoints to work with the beneficiaries
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{sessionToken}}"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"6785c0c4-7006-4403-abf2-ea4904e9632d","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"59c6596d-2cb5-463b-89f9-4a77c0860925","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"_postman_id":"d011a139-497a-4023-810f-e855a2b6cbb1"},{"name":"Payment Instrument","item":[{"name":"Get Required Fields [V2]","id":"83a34289-206c-40b8-872a-3b9258926c92","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"PaymentType\": \"BUS_USD_Account.Stablecoin_Withdraw\"\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/v2/payment-instrument/get-required-fields","description":"This endpoint is used to get all the fields that are needed to create a payment instrument based on the payment type.
\nThis endpoint is used to create a payment instrument associated with a beneficiary.
\nAdditional Info
\nAdditional_Info is an optional field. However, it becomes required if the bank details cannot be automatically retrieved using the provided Routing Number or SWIFT Code.
\nIn such cases, you must include the bank details inside the additional_info object.
Bank_Name
Bank_Address
Bank_City
Bank_State
Bank_Postal_Code
Bank_Country
{ \"additional_info\": { \"Bank_Name\": \"Example Bank\", \"Bank_Address\": \"123 Main Street\", \"Bank_City\": \"New York\", \"Bank_State\": \"NY\", \"Bank_Postal_Code\": \"10001\", \"Bank_Country\": \"US\" } }
Note: Use Get Bank Details endpoint to fetch beneficiary bank details using routing number.
\nThis endpoint is used to get the list of payment instruments associated with a particular beneficiary.
\nThis endpoint is used to get detailed information about a payment instrument.
\nThis endpoint is used to change status of a payment instrument ID
\nNote: \"Permission Denied\" message is returned with status code 400 when \"Status\" in request body is same as the Payment Instrument status.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{sessionToken}}"}]},"isInherited":true,"source":{"_postman_id":"863636f7-0488-42ae-834c-dc60b97a8390","id":"863636f7-0488-42ae-834c-dc60b97a8390","name":"Payment Instrument","type":"folder"}},"urlObject":{"path":["v2","payment-instrument","change-status"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[{"id":"af6d18d0-102c-458b-a30e-49f511ce5a1c","name":"Change Status [Enable]","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":" {\n \"BeneficiaryId\": \"{{beneficiaryIDV2}}\",\n \"Status\": \"Active\"\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/v2/beneficiary/change-status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"x-powered-by","value":"Express"},{"key":"content-security-policy","value":"default-src 'self';base-uri 'self';block-all-mixed-content;font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests"},{"key":"cross-origin-embedder-policy","value":"require-corp"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"cross-origin-resource-policy","value":"same-origin"},{"key":"x-dns-prefetch-control","value":"off"},{"key":"expect-ct","value":"max-age=0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains"},{"key":"x-download-options","value":"noopen"},{"key":"x-content-type-options","value":"nosniff"},{"key":"origin-agent-cluster","value":"?1"},{"key":"x-permitted-cross-domain-policies","value":"none"},{"key":"referrer-policy","value":"no-referrer"},{"key":"x-xss-protection","value":"0"},{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"content-length","value":"125"},{"key":"etag","value":"W/\"7d-ltQTCG9BD7gLU6koSV+BMpZiICo\""},{"key":"x-execution-time","value":"11605"},{"key":"vary","value":"Accept-Encoding, Authorization, Cookie"},{"key":"date","value":"Tue, 10 Jan 2023 07:36:09 GMT"},{"key":"connection","value":"keep-alive"},{"key":"keep-alive","value":"timeout=5"},{"key":"cache-control","value":"private"}],"cookie":[],"responseTime":null,"body":"{\n \"ResponseCode\": 200,\n \"ResponseMessage\": \"Success\",\n \"ResponseData\": \"Beneficiary has been enabled for transactions successfully.\"\n}"},{"id":"2a65d3cc-d9e5-477d-b62f-f6c01cd6cc09","name":"Change Status [Disable]","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":" {\n \"BeneficiaryId\": \"{{beneficiaryIDV2}}\",\n \"Status\": \"Disable\"\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/v2/beneficiary/change-status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"x-powered-by","value":"Express"},{"key":"content-security-policy","value":"default-src 'self';base-uri 'self';block-all-mixed-content;font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests"},{"key":"cross-origin-embedder-policy","value":"require-corp"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"cross-origin-resource-policy","value":"same-origin"},{"key":"x-dns-prefetch-control","value":"off"},{"key":"expect-ct","value":"max-age=0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains"},{"key":"x-download-options","value":"noopen"},{"key":"x-content-type-options","value":"nosniff"},{"key":"origin-agent-cluster","value":"?1"},{"key":"x-permitted-cross-domain-policies","value":"none"},{"key":"referrer-policy","value":"no-referrer"},{"key":"x-xss-protection","value":"0"},{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"content-length","value":"126"},{"key":"etag","value":"W/\"7e-w6n4xiKyJ+JzIJ/BS7VEB5HXjpg\""},{"key":"x-execution-time","value":"6143"},{"key":"vary","value":"Accept-Encoding, Authorization, Cookie"},{"key":"date","value":"Tue, 10 Jan 2023 07:36:59 GMT"},{"key":"connection","value":"keep-alive"},{"key":"keep-alive","value":"timeout=5"},{"key":"cache-control","value":"private"}],"cookie":[],"responseTime":null,"body":"{\n \"ResponseCode\": 200,\n \"ResponseMessage\": \"Success\",\n \"ResponseData\": \"Beneficiary has been disabled for transactions successfully.\"\n}"}],"_postman_id":"34f37c0e-1b2e-4bf2-bb8b-270c5ba677e4"}],"id":"863636f7-0488-42ae-834c-dc60b97a8390","description":"Payment instruments comprise different payment types inside a beneficiary. Payment instrument contains information related to bank account and payment type along with information needed to perform a payment.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{sessionToken}}"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"c94355de-1552-47f6-ba5f-6db577117c65","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"51d11f23-893a-4c4e-87cb-e18e4e8bdaaa","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"_postman_id":"863636f7-0488-42ae-834c-dc60b97a8390"},{"name":"Payments","item":[{"name":"Preview - Send Bank Payment [V2]","event":[{"listen":"test","script":{"id":"ecb1eb98-eb13-4b34-a6f5-62402ba877e8","exec":["var jsonData = pm.response.json();","pm.environment.set(\"transactionNumber\", jsonData.ResponseData.TransactionNumber);"],"type":"text/javascript","packages":{}}}],"id":"11060ce3-d290-45e3-9cea-53cf8cb4c0a3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"BeneficiaryPaymentInstrumentID\": \"{{PaymentInstrumentID}}\",\n \"Purpose\": \"Loan_Payments\",\n \"Currency\": \"USD\",\n \"Amount\": \"300\",\n \"CryptoBuySellActivity\": \"No\",\n \"SupportingDocument\": \"{{FileId}}\",\n \"DocumentReferenceNumber\":\"1123123\",\n \"Intermediary_ABA\": \"026001591\",\n \"Description\": \"lorem ipsum dummy text\"\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/v2/payment/bank/preview","description":"This endpoint requires the same request body as create bank transfer endpoint. The difference between them is the former one validates the request body (provides error message if any), lists the fee involved, and the details of the transaction.
\nThe endpoint is used to make the payment to the beneficiary that was added early using any of the payment instrument Id associated with that beneficiary. The associated beneficiary status must be Enabled to send the payment.
Note:
1. The payment might need one or more authorization from the bank. Merchant partner will be notified on such changes via callbacks to the designated URL.
2. Swift code provided while creating payment instrument will also get verfied in this endpoint.
These endpoints are used to create a transaction for different payment types using a payment instrument.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{sessionToken}}"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"9d8b51dd-57a7-4e57-bedd-6be8eb292d45","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"a1ed3b9e-3678-470d-9215-a7d442b643d6","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"_postman_id":"32074d9c-244f-4f31-b342-cecbaacd5977"},{"name":"Stablecoin","item":[{"name":"Preview- Stablecoin Withdraw","id":"1a5b8a7b-1b14-4dd2-ac65-a18cc83d8be0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"BeneficiaryPaymentInstrumentID\": \"{{PaymentInstrumentID}}\",\n \"Amount\": \"400\",\n \"Description\": \"Testing apis\"\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/v2/stablecoin/withdraw/preview","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{sessionToken}}"}]},"isInherited":true,"source":{"_postman_id":"5df8538f-dcee-4975-9fc4-9326a51bed9a","id":"5df8538f-dcee-4975-9fc4-9326a51bed9a","name":"Stablecoin","type":"folder"}},"urlObject":{"path":["v2","stablecoin","withdraw","preview"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"1a5b8a7b-1b14-4dd2-ac65-a18cc83d8be0"},{"name":"Transfer - Stablecoin Withdraw","id":"1c5d225e-fa81-4b28-ada5-5519714d102e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"BeneficiaryPaymentInstrumentID\": \"{{PaymentInstrumentID}}\",\n \"Amount\": \"0.01\",\n \"Description\": \"Testing apis\"\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/v2/stablecoin/withdraw","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{sessionToken}}"}]},"isInherited":true,"source":{"_postman_id":"5df8538f-dcee-4975-9fc4-9326a51bed9a","id":"5df8538f-dcee-4975-9fc4-9326a51bed9a","name":"Stablecoin","type":"folder"}},"urlObject":{"path":["v2","stablecoin","withdraw"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"1c5d225e-fa81-4b28-ada5-5519714d102e"}],"id":"5df8538f-dcee-4975-9fc4-9326a51bed9a","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{sessionToken}}"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"0d4f154b-a3db-4997-9ffb-46e02b2ec370","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"c03f81e4-1404-4ee9-8774-483e190dfb61","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"_postman_id":"5df8538f-dcee-4975-9fc4-9326a51bed9a","description":""},{"name":"SEPA Payments","item":[{"name":"Preview - Send SEPA Payment","id":"affcbff5-f01e-495e-b093-11631a2cc3ed","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"BeneficiaryPaymentInstrumentID\": \"{{PaymentInstrumentID}}\",\n \"Purpose\": \"Savings\",\n \"Description\": \"Testing Payment endpoint (Business Endpoint)\",\n \"DestinationAmount\": \"12\",\n \"DestinationCurrency\": \"EUR\",\n \"CryptoBuySellActivity\": \"Yes\",\n \"SupportingDocument\": \"{{FileId}}\",\n \"DocumentReferenceNumber\": \"234234\"\n}\n\n\n\n","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/v2/cross-border/preview","description":"The \"Preview - Send SEPA Payment\" endpoint is a significant component in managing SEPA (Single Euro Payments Area) transactions efficiently. In the initial step, users provide essential details, including the Payment Instrument ID, payment purpose, description, destination amount and destination currencies, and the transaction amount.
\nUpon a successful request, the endpoint returns a comprehensive preview of the SEPA transaction, encompassing critical details such as fees, exchange rates, and the newly generated QuoteID.
\nThe \"SEND Cross Border Payment\" endpoint offers users the capability to initiate cross-border transactions with precision. Users can input essential transaction details, including the Payment Instrument ID, payment purpose, description, destination amount, destination currency, and CryptoBuySellActivity flag.
\nThe \"SupportingDocument\" attribute allows for the attachment of relevant documents using the File ID obtained from the \"Upload File\" endpoint. Importantly, if users do not specify a Quote ID in the request body, the endpoint will generate a new Quote ID automatically.
\nThese endpoints are used to create a transaction for different payment types using a payment instrument.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{sessionToken}}"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"2dab4246-3650-48e8-b7ec-c5403643c448","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"8f01d5cb-f24b-479c-850b-f1afd78cfa91","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"_postman_id":"f79e0ade-7298-48f9-9881-4407ca640cd0"},{"name":"Custody","item":[{"name":"Get Custody Account Status","id":"004d0dbb-9f86-439e-b1f1-fa7f07f8e4df","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"Asset\": \"BTC\"\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/v2/custody/status","description":"This endpoint is used to get custody application status and balance of the custody account.
\nThis endpoint is used to apply for a custody application
\nThis endpoint is used to preview a custody transaction and fee to be applied for the transaction
\nThis endpoint is used to transfer digital assets using a custody payment instrument.
\nThese endpoints are used to apply for custody accounts and perform digital asset payments to different address using payment instruments
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{sessionToken}}"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"515d31ef-4c3c-4444-a810-f0463727ca62","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"6908588a-ee6c-412d-80e5-986c80e2c9a2","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"_postman_id":"22092c61-7208-48c0-bd5b-f6bf10e49d95"},{"name":"Transactions","item":[{"name":"Get Transaction Details","id":"4c310554-dccc-4e79-8e2b-7fa9941fe712","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{baseURL}}/v2/transactions/details/:transactionNumber","description":"To get the details about a transaction. Transaction number can be any of the response from payment or transfer endpoint.
\nReturns all the transactions that were incomplete, rejected, canceled, or failed.
\nReturns all the completed transactions of the client.
\nUse the Send Webhook endpoint to easily trigger the webhook for the the latest transaction state by providing the transaction number in the request body,
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{sessionToken}}"}]},"isInherited":true,"source":{"_postman_id":"f841678a-13c0-495d-a83a-b3fba1058496","id":"f841678a-13c0-495d-a83a-b3fba1058496","name":"Transactions","type":"folder"}},"urlObject":{"path":["v2","transactions","send-webhook"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[{"id":"7213fb74-bc04-4d74-ab84-bb8e8d1c97da","name":"Re-Send Webhook (Success)","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"TransactionNumber\": \"FV000020154\"\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/transactions/send-webhook"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"x-powered-by","value":"Express"},{"key":"content-security-policy","value":"default-src 'self';base-uri 'self';block-all-mixed-content;font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests"},{"key":"cross-origin-embedder-policy","value":"require-corp"},{"key":"cross-origin-opener-policy","value":"same-origin"},{"key":"cross-origin-resource-policy","value":"same-origin"},{"key":"x-dns-prefetch-control","value":"off"},{"key":"expect-ct","value":"max-age=0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"strict-transport-security","value":"max-age=15552000; includeSubDomains"},{"key":"x-download-options","value":"noopen"},{"key":"x-content-type-options","value":"nosniff"},{"key":"origin-agent-cluster","value":"?1"},{"key":"x-permitted-cross-domain-policies","value":"none"},{"key":"referrer-policy","value":"no-referrer"},{"key":"x-xss-protection","value":"0"},{"key":"access-control-allow-origin","value":"*"},{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"content-length","value":"116"},{"key":"etag","value":"W/\"74-RM6pp/NbpR72hc7o6I/mYvikHNU\""},{"key":"x-execution-time","value":"1076"},{"key":"vary","value":"Accept-Encoding, Authorization, Cookie"},{"key":"date","value":"Wed, 08 Nov 2023 09:25:24 GMT"},{"key":"connection","value":"keep-alive"},{"key":"keep-alive","value":"timeout=5"},{"key":"cache-control","value":"private"}],"cookie":[],"responseTime":null,"body":"{\n \"ResponseCode\": 200,\n \"ResponseMessage\": \"Success\",\n \"ResponseData\": {\n \"WebhookId\": \"7bdeb64f-50b2-4624-87ea-4fa111282e8e\"\n }\n}"}],"_postman_id":"b881413f-1da3-4044-beb9-e30de6c6834f"}],"id":"f841678a-13c0-495d-a83a-b3fba1058496","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{sessionToken}}"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"eeb14c5e-49b7-4b91-9f83-973b33680510","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"843be248-299e-496e-9079-dd4a6ef05360","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"_postman_id":"f841678a-13c0-495d-a83a-b3fba1058496","description":""},{"name":"Files","item":[{"name":"Get File","id":"95935b9b-cbcc-4ab5-a6ee-450cd422a1de","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{baseURL}}/v2/files/:FileId","description":"This endpoint takes a temp file ID as a path variable and returns the image or document that was previously uploaded using the Upload File endpoint. The response will contain the file in its original format.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{sessionToken}}"}]},"isInherited":true,"source":{"_postman_id":"9cf860b8-0688-4b63-a9f7-d01a9d34afee","id":"9cf860b8-0688-4b63-a9f7-d01a9d34afee","name":"Files","type":"folder"}},"urlObject":{"path":["v2","files",":FileId"],"host":["{{baseURL}}"],"query":[],"variable":[{"id":"3b6352d6-189b-4161-873c-07e70feacfa9","type":"any","value":"{{FileId}}","key":"FileId"}]}},"response":[],"_postman_id":"95935b9b-cbcc-4ab5-a6ee-450cd422a1de"},{"name":"Get File Details","id":"6cce6a24-3ebd-4411-98a5-5a0b3c796517","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{baseURL}}/v2/files/details/:FileId","description":"This endpoint takes a temp file ID as a path variable and returns details about the file such as its name and format. The response will contain metadata about the file that was previously uploaded using the Upload File endpoint.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{sessionToken}}"}]},"isInherited":true,"source":{"_postman_id":"9cf860b8-0688-4b63-a9f7-d01a9d34afee","id":"9cf860b8-0688-4b63-a9f7-d01a9d34afee","name":"Files","type":"folder"}},"urlObject":{"path":["v2","files","details",":FileId"],"host":["{{baseURL}}"],"query":[],"variable":[{"id":"14eaeb4b-9dc3-463f-98ae-ee697b6ba0f2","type":"any","value":"{{FileId}}","key":"FileId"}]}},"response":[],"_postman_id":"6cce6a24-3ebd-4411-98a5-5a0b3c796517"},{"name":"Upload File","event":[{"listen":"test","script":{"id":"20830f33-a27f-4e0d-a818-2958b4ab1058","exec":["var jsonData = pm.response.json();","if(!!jsonData?.ResponseData?.ID){"," pm.environment.set(\"FileId\", jsonData.ResponseData.ID);","}",""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"301b6634-8cb9-4ee9-b8bc-a5ef1bde06fb","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{}},"request":{"method":"POST","header":[],"body":{"mode":"file","file":{"src":"/Users/rajesh/Downloads/dummy-pdf_2.pdf"}},"url":"{{baseURL}}/v2/files/upload?customField=Payment_Invoice&fileName=Ducket.pdf","description":"The Upload File endpoint allows you to upload documents and retrieve a File ID, which can then be used across different APIs wherever file-type parameters are required.
\nThis is a foundational endpoint used in multiple flows such as:
\nOutbound Bank Payments (e.g., invoices, supporting documents)
\nVirtual Account creation (KYC/identity documents)
\nYou upload a file using this endpoint
\nThe system returns a File ID
\nThis File ID is then passed in other API requests wherever required
\ncustomField β Defines where this file will be used
fileName β Name of the file (must include correct extension, e.g., .pdf, .png)
The File ID is mandatory for any file-type field
\nEnsure customField matches the exact field where the file will be used
fileName must match the actual file type being uploaded
Files uploaded here are reusable across flows
\nMaximum file size: 5 MB
\nMaximum file name length: 100 characters
\nUpload invoice β use File ID in SupportingDocument while creating payment
Upload ID proof β use File ID in Front_Document / Back_Document during beneficiary creation
Upload File β Get File ID β Use in Payments / Beneficiary / Virtual Account APIs\n\nThis ensures a consistent and reusable document handling mechanism across the system.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{sessionToken}}"}]},"isInherited":true,"source":{"_postman_id":"9cf860b8-0688-4b63-a9f7-d01a9d34afee","id":"9cf860b8-0688-4b63-a9f7-d01a9d34afee","name":"Files","type":"folder"}},"urlObject":{"path":["v2","files","upload"],"host":["{{baseURL}}"],"query":[{"key":"customField","value":"Payment_Invoice"},{"key":"fileName","value":"Ducket.pdf"}],"variable":[]}},"response":[],"_postman_id":"301b6634-8cb9-4ee9-b8bc-a5ef1bde06fb"}],"id":"9cf860b8-0688-4b63-a9f7-d01a9d34afee","description":"The \"Files\" section of this API provides functionality to upload and retrieve files in various formats such as png, jpg, jpeg and pdf. This section contains three endpoints which are described below:
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{sessionToken}}"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"14947baf-6f42-4dcb-9a28-a436d079cd7c","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"7b2c6442-41b1-4955-abd6-62094c18e332","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"_postman_id":"9cf860b8-0688-4b63-a9f7-d01a9d34afee"}],"id":"3879924f-a111-441f-b4c9-5f6a05ec7f07","description":"The API Reference section provides a comprehensive list of all available endpoints in the FV Merchant API suite, organized by functional categories.
\nEach endpoint includes:
\nRequest structure and required parameters
\nSample request/response examples
\nField-level details for accurate integration
\nUse this section as a technical reference while building your integration
\nFollow the Use Cases section for end-to-end flows, and refer here for exact API details
\nIdentify the relevant category (e.g., Beneficiaries, Payments, Transactions) and explore the endpoints within it
\nThe APIs are grouped based on their functionality:
\nBeneficiaries β Create and manage recipients
\nPayment Methods β Add and manage payment instruments
\nPayments β Initiate outbound transactions (bank & stablecoin)
\nTransactions β Retrieve transaction details and history
\nAccounts β View balances and deposit instructions
\nFiles β Upload and manage supporting documents
\nThese webhooks notify you about outbound transaction lifecycle events in the FV Bank systemβfrom creation to final status updates.
\nTRANSACTION_STATUSThe TRANSACTION_STATUS webhook has a different payload structure compared to other transaction events.
It includes status changes from the beneficiary bank side
\nShould be used to track progress after initiation
\nTRANSACTION_STATUS){\n \"Date\": \"2023-06-15T07:46:18\",\n \"Data\": {\n \"CreatedDate\": \"2023-06-15T07:46:18.150Z\",\n \"TransactionNumber\": \"FV000017423\",\n \"Type\": \"Payment - Domestic (ACH)\",\n \"Amount\": \"1.00\",\n \"From\": \"Rishav_Business - Rishav\",\n \"To\": \"Johnie Rogan\",\n \"Currency\": \"USD\",\n \"Description\": \"Rent payment\",\n \"Purpose\": \"Savings\",\n \"AdditionalData\": [\n { \"label\": \"Routing Number\", \"value\": \"026001591\" },\n { \"label\": \"Account Number\", \"value\": \"118877665101\" },\n { \"label\": \"Bank_Account_Type\", \"value\": \"Saving\" },\n { \"label\": \"Beneficiary First Name\", \"value\": \"Johnie\" },\n { \"label\": \"Beneficiary Last Name\", \"value\": \"Johnie Rogan\" }\n ]\n },\n \"Event\": \"TRANSACTION_CREATED\",\n \"Id\": \"03539a28-4453-425d-9720-15037d0ef027\",\n \"Message\": \"Transaction created\"\n}\n\n{\n \"Date\": \"2022-05-18T07:32:22\",\n \"Data\": {\n \"CreatedDate\": \"2022-05-18T07:30:44.863Z\",\n \"NewStatus\": \"COMPLETED\",\n \"OldStatus\": \"IN PROCESS\",\n \"TransactionNumber\": \"FV000004645\",\n \"Type\": \"Payment - Domestic Wire\"\n },\n \"AdditionalData\": [\n { \"label\": \"Routing Number\", \"value\": \"026001591\" },\n { \"label\": \"Account Number\", \"value\": \"118877665101\" },\n { \"label\": \"Bank_Account_Type\", \"value\": \"Saving\" },\n { \"label\": \"Beneficiary First Name\", \"value\": \"Johnie\" },\n { \"label\": \"Beneficiary Last Name\", \"value\": \"Johnie Rogan\" }\n ],\n \"Event\": \"TRANSACTION_STATUS\",\n \"Message\": \"The member transaction status changed\"\n}\n\nUse TRANSACTION_CREATED to detect that an outbound payment has been initiated and is awaiting compliance review
Use TRANSACTION_AUTHORIZED to confirm the payment has passed compliance checks and is approved for processing
Use TRANSACTION_STATUS to track real-time updates once funds movement has begun (e.g., processing, completed)
Use TRANSACTION_DENIED, TRANSACTION_CANCELLED, and TRANSACTION_EXPIRED as failure or terminal states requiring attention or retry logic
Always verify webhook signatures before processing
\nHandle duplicate events (idempotency)
\nUse TransactionNumber to reconcile with your system
Compliance Flow β CREATED β AUTHORIZED / DENIED β CANCELLED / EXPIRED \nExecution Flow β STATUS (IN PROCESS β COMPLETED / FAILED)\n\nThese webhooks allow you to build real-time tracking and reconciliation for all outbound payments.
\n","_postman_id":"31393443-17b8-4399-a1ec-139d6305e506"},{"name":"Deposit Webhooks","item":[],"id":"d4d3ba53-19ec-4298-8a30-b2682e7e7b41","description":"These webhooks notify you about incoming deposits to your FV Bank account, including their compliance lifecycle and final outcome.
\n{\n \"Date\": \"2022-01-13T04:41:53\",\n \"Data\": {\n \"CreatedDate\": \"2023-02-17T11:09:31.609Z\",\n \"TransactionNumber\": \"FV000014212\",\n \"Type\": \"Deposit - Domestic Wire\",\n \"Amount\": \"3999600.00\",\n \"From\": \"FALCONX LIMITED\",\n \"To\": \"Raj Biz Co - Raj Biz\",\n \"Currency\": \"USD\",\n \"Description\": \"DEPOSIT REFERENCE: 7801000107\",\n \"AdditionalData\": [\n {\n \"label\": \"Originator Name\",\n \"value\": \"FALCONX LIMITED\"\n },\n {\n \"label\": \"Originator Account Number\",\n \"value\": \"5090013995\"\n },\n {\n \"label\": \"Originator Address\",\n \"value\": \"LEVEL G, OFFICE 1/1191, QUANTUM HOUSE 75 ABATE RIGORD STREET\"\n },\n {\n \"label\": \"IMAD\",\n \"value\": \"20220913MMQFMPUR001023\"\n },\n {\n \"label\": \"OMAD\",\n \"value\": \"20220913GMQFMP0101552709131240\"\n },\n {\n \"label\": \"Import Key\",\n \"value\": \"2ac616d6-9a7c-4bae-8aeb-ea6d494f6fdb\"\n }\n ]\n },\n \"Event\": \"DEPOSIT_RECEIVED\",\n \"Message\": \"Deposit created\"\n}\n\nIf a deposit is made to a virtual account mapped to a beneficiary, an additional field will be included in the webhook payload:
\n{\n \"Date\": \"2022-01-13T04:41:53\",\n \"Data\": {\n \"CreatedDate\": \"2023-02-17T11:14:25.634Z\",\n \"TransactionNumber\": \"FV000014214\",\n \"Type\": \"Deposit - Domestic Wire\",\n \"Amount\": \"400000\",\n \"From\": \"FALCONX LIMITED\",\n \"To\": \"Raj Biz Co - Raj Biz\",\n \"Currency\": \"USD\",\n \"Description\": \"780008000006\",\n \"AdditionalData\": [\n {\n \"label\": \"Originator Name\",\n \"value\": \"FALCONX LIMITED\"\n },\n {\n \"label\": \"Originator Account Number\",\n \"value\": \"5090013995\"\n },\n {\n \"label\": \"Originator Address\",\n \"value\": \"LEVEL G, OFFICE 1/1191, QUANTUM HOUSE 75 ABATE RIGORD STREET\"\n },\n {\n \"label\": \"IMAD\",\n \"value\": \"20220913MMQFMPUR001023\"\n },\n {\n \"label\": \"OMAD\",\n \"value\": \"20220913GMQFMP0101552709131240\"\n },\n {\n \"label\": \"Import Key\",\n \"value\": \"2ac616d6-9a7c-4bae-8aeb-ea6d494f6fdb\"\n },\n {\n \"label\": \"Virtual Account\",\n \"value\": \"780008000006\"\n }\n ]\n },\n \"Event\": \"DEPOSIT_RECEIVED\",\n \"Message\": \"Deposit created\"\n}\n\nUse DEPOSIT_RECEIVED to detect incoming funds awaiting approval
Use DEPOSIT_AUTHORIZED as the final success state (funds credited)
Handle DENIED, CANCELLED, and RETURNED as failure scenarios
Deposits follow a compliance-driven lifecycle similar to payments
\nFunds are only available after DEPOSIT_AUTHORIZED
Always use TransactionNumber for reconciliation
Additional details (originator info, bank references) are available in AdditionalData
RECEIVED β AUTHORIZED (Success) \n β DENIED / CANCELLED / RETURNED (Failure)\n\nThese webhooks enable real-time tracking and reconciliation of incoming funds into your FV account.
\n","_postman_id":"d4d3ba53-19ec-4298-8a30-b2682e7e7b41"}],"id":"22842df9-8d9d-4cd5-a4ee-43679c8a6eb5","description":"Webhooks allow you to receive real-time notifications about important events related to outbound and inbound transactions in your FV Merchant account, eliminating the need to continuously poll APIs.
\nWhen an event occurs (e.g., payment status update or deposit confirmation), FV Bank sends an HTTP POST request to your configured webhook URL with event details.
\nEvent Occurs β FV System β Webhook POST β Your Server β Process Event\n\nTo receive webhooks, you must provide a publicly accessible HTTPS endpoint.
\nThe endpoint must accept POST requests
\nIt should return a 200 OK response to acknowledge successful receipt
\nNon-200 responses will trigger retries
\nEach webhook request includes a signature header to verify authenticity.
\nx-webhook-signature: <signature>\n\nUse your webhook secret key
\nCompute HMAC SHA256 of the request payload
\nCompare with the signature header
\nExample (Node.js):
\nconst crypto = await import('crypto');\nconst signature = res.headers['x-signature'];\nconst hmac = crypto.createHmac('sha256', CLIENT_SECRET);\nconst expectedSignature = hmac.update(JSON.stringify(res.body?.Data)).digest('hex');\nconst a = Buffer.from(signature);\nconst b = Buffer.from(expectedSignature);\nif (crypto.timingSafeEqual(a, b)) {\n console.log('Matched');\n} else {\n console.log('Signature Not Matched');\n}\n\nIf your server does not return a 200 OK response:
The webhook will be retried automatically
\nMultiple retry attempts will be made with increasing intervals
\n\n\nEnsure your endpoint is idempotent to safely handle duplicate events
\n
Verify webhook signatures before processing
\nStore processed event IDs to prevent duplication
\nUse webhooks for real-time updates and APIs for reconciliation
\nAlways return 200 OK quickly, then process asynchronously
Webhooks provide a reliable way to stay updated on:
\nPayments β Status Updates \nDeposits β Confirmation Events \n\nThey are essential for building real-time, event-driven integrations.
\n","_postman_id":"22842df9-8d9d-4cd5-a4ee-43679c8a6eb5"},{"name":"β οΈ Errors","item":[],"id":"5b3c5a4e-f477-4618-aa9e-511d59f1d139","description":"The FV Merchant APIs use standard HTTP status codes along with a structured response body to indicate success or failure of a request.
\nAll error responses follow a consistent format:
\nInvalid or expired SessionToken
\nMissing Authorization / X-AUTH-TOKEN header
π Fix: Regenerate token via /auth
Missing required fields
\nIncorrect field formats (email, amount, etc.)
\nInvalid enum values
\nπ Fix: Validate request body against API specs
\nInvalid Beneficiary / Payment Instrument ID
\nInsufficient balance
\nCompliance rejection
\nπ Fix: Verify data and transaction eligibility
\nFile size exceeds limit (5 MB)
\nInvalid file type or name
\nIncorrect customField mapping
π Fix: Follow file constraints and mapping rules
\nPayment denied or expired
\nInvalid transaction state
\nDuplicate or conflicting request
\nπ Fix: Use Transaction APIs or Webhooks to verify state before retrying
\nIf API returns 401 Unauthorized, regenerate SessionToken
\nIf x-refresh-token is returned in headers:
Replace existing token
\nContinue without re-authentication
\nAlways log ResponseCode and ResponseMessage
Use Webhooks to track transaction failures
\nImplement retry logic only for safe operations
\nAvoid retrying failed payments without validation
\n