# /transaction/create

Creates a new money transfer transaction. 

This endpoint validates sender and beneficiary data, applies compliance checks, and registers the transaction for processing.

Endpoint: POST /transaction/create
Version: 1.0.0

## Request fields (application/json):

  - `client_id` (string, required)
    Unique identifier assigned to the integrating client. It determines the validation rules, allowed values, compliance policies, and operational limits applied to the request.Error codes (click to expand)RuleCoderequired400001type400002minLength400003maxLength400004

  - `secret_key` (string, required)
    Secret authentication key associated with the client. It is used to authorize the request and must be kept strictly confidential.Error codes (click to expand)RuleCoderequired400005type400006minLength400007maxLength400008

  - `sender` (object, required)
    Contains the personal and identification information of the transaction sender.

 All fields are subject to AML, KYC, and compliance validation rules. 

This information is used to verify the identity of the person initiating the transaction and to evaluate regulatory and risk requirements.Error codes (click to expand)RuleCoderequired400011type400012

  - `sender.firstName` (string, required)
    Sender’s given (first) name as it appears on their official identification document.Error codes (click to expand)RuleCoderequired400013type400014minLength400015maxLength400016

  - `sender.middleName` (string)
    Sender’s middle name, if applicable.Error codes (click to expand)RuleCoderequired400017type400018minLength400019maxLength400020

  - `sender.lastName` (string, required)
    Sender’s primary family name (surname).Error codes (click to expand)RuleCoderequired400021type400022minLength400023maxLength400024

  - `sender.secondLastName` (string)
    Sender’s second family name, used in some countries.Error codes (click to expand)RuleCoderequired400025type400026minLength400027maxLength400028

  - `sender.phone` (string, required)
    Sender’s phone number without country code.Error codes (click to expand)RuleCoderequired400029type400030minLength400031maxLength400032

  - `sender.phoneCountryCode` (string, required)
    International dialing code of the sender’s phone numberError codes (click to expand)RuleCoderequired400033type400034minLength400035maxLength400036allowedValues400087
    Enum: "+52"

  - `sender.email` (string, required)
    Sender’s email address used for notifications and transaction updates.Error codes (click to expand)RuleCoderequired400037type400038minLength400039maxLength400040format400041

  - `sender.addressStreet` (string, required)
    Sender address. Structure: [Description, city name, State ISO2 zipCode, Country ISO3]. Example:'54545 Salo Rd, Hancock, MI 49930, USA' Regular expression: ^[0-9]+\s[\w\s.,-]+$Error codes (click to expand)RuleCoderequired400042type400043minLength400044maxLength400045

  - `sender.addressState` (string, required)
    Sender state (ISO 2).  https://en.wikipedia.org/wiki/ISO_3166-2Error codes (click to expand)RuleCoderequired400047type400048minLength400049maxLength400050

  - `sender.addressCity` (string, required)
    City name of the sender’s residence.Error codes (click to expand)RuleCoderequired400051type400052minLength400053maxLength400054

  - `sender.addressCountry` (string, required)
    Sender country (ISO 3). https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3Error codes (click to expand)RuleCoderequired400055type400056minLength400057maxLength400058allowedValues400085
    Enum: "TCD", "COL", "DOM", "COD", "GNB", "HTI", "JAM", "MEX", "MAR", "MOZ", "NER", "PAK", "PHL", "TUR", "ALB", "BOL", "CMR", "CAF", "CRI", "ECU", "SLV", "GHA", "GTM", "HND", "IDN", "KEN", "KGZ", "LBR", "MLI", "MRT", "NIC", "NGA", "PER", "SEN", "TZA", "THA", "AND", "ARG", "AUS", "AUT", "AZE", "BGD", "BEL", "BEN", "BIH", "BRA", "BGR", "BFA", "CAN", "CHL", "COG", "HRV", "CYP", "CZE", "DNK", "ERI", "EST", "SWZ", "FIN", "FRA", "GAB", "GMB", "GEO", "DEU", "GIB", "GRC", "GIN", "HKG", "HUN", "ISL", "IND", "IRL", "ITA", "CIV", "LVA", "LIE", "LTU", "LUX", "MDG", "MYS", "MLT", "MCO", "NPL", "NLD", "NZL", "NOR", "POL", "PRT", "ROU", "RWA", "SMR", "SLE", "SVK", "SVN", "KOR", "ESP", "LKA", "SWE", "CHE", "TGO", "UGA", "GBR", "USA", "URY", "VNM", "ZMB"

  - `sender.addressZipCode` (string, required)
    Postal or ZIP code of the sender’s address.Error codes (click to expand)RuleCoderequired400100type400101minLength400102maxLength400103

  - `sender.documentType` (string, required)
    Type of identification document provided by the sender (e.g., Passport, National ID).  

Document types (documentType) — click to expandCodeDocument TypeDescriptionBDBORDER CROSSING CARDBorder crossing card used to enter certain countries without a passport.BFCPF/CNPJBrazilian tax registry for individuals (CPF) and legal entities (CNPJ).CACARTEIRA DE IDENTIDADEIdentity document issued in Brazil.CCCÉDULA CIUDADANÍAIdentification document in Colombia.CECÉDULA DE IDENTIDAD Y ELECTORALIdentity document used in the Dominican Republic.CICÉDULA DE IDENTIDADIdentity document issued in various Latin American countries.CLCREDENCIAL DE ELECTORVoter identification document used in Mexico.CNCERTIFICATE OF NATURALIZATIONNaturalization certificate that grants citizenship in the U.S. or other countries.CPCADASTRO DE PESSOAS FÍSICAS (CPF)Tax registry for individuals in Brazil.CRCREW LANDING PERMIT & BADGELanding permit for aircraft crew members.CVCÉDULA DE VECINDADIdentity document in Guatemala.CZCERTIFICATE OF CITIZENSHIPCitizenship certificate issued by national governments.DIDOCUMENTO NACIONAL DE IDENTIDAD (DNI)Identity document in Argentina, Spain, and other countries.DLDRIVER'S LICENSEDriver's license.DNDOCUMENTO NACIONALNational identity document.DUDOCUMENTO ÚNICO DE IDENTIDAD (DUI)Identity document in El Salvador.EAEMPLOYMENT AUTHORIZATIONEmployment authorization document in the U.S.GCGREEN CARDPermanent residence card in the U.S.GIGOVERNMENT IDENTIFICATIONIdentification issued by the government for its citizens.ICCÉDULA DE IDENTIDAD CIVILCivil identity document in several countries.IDIDENTIFICATION CARDGeneral identification card.LDDRIVER'S LICENSEDriver's license.LELIBRETA ELECTORALElectoral document in Peru.LPLEARNER PERMITLearner's permit for driving.MCMATRÍCULA CONSULARIdentity document issued by consulates to citizens abroad.MIMILITARY IDMilitary identification.NNNONENo identity document required.OIOFFICIAL ID (POLICE, FIRE, ETC)Official identification for police, firefighters, etc.OTOTHEROther type of identity document.PAPASSPORTPassport issued by a government.PCPASSPORT CARDPassport card used in the U.S. for certain international travel.PPPASAPORTEPassport.PRPERMANENT RESIDENT CARDPermanent residence card in some countries.RARESIDENT ALIENDocument for a foreign resident.SISTATE ISSUED IDIdentification issued by a state or province.SSSSNSocial Security Number (U.S.).TITARJETA DE IDENTIDADIdentity card in some Latin American countries.TRTARJETA DE REGISTRO CONSULARConsular registration card for citizens abroad.VIVISAEntry visa for a country.Error codes (click to expand)RuleCoderequired400059type400060minLength400061maxLength400062

  - `sender.documentDescription` (string, required)
    Human-readable description of the identification document.Error codes (click to expand)RuleCoderequired400063type400064minLength400065maxLength400066

  - `sender.documentNumber` (string, required)
    Identification document number.Error codes (click to expand)RuleCoderequired400067type400068minLength400069maxLength400070

  - `sender.documentExpirationDate` (string)
    Expiration date of the identification document.Error codes (click to expand)RuleCoderequired400071type400072minLength400074maxLength400075format400073

  - `sender.documentCountry` (string)
    Sender country (ISO 3). https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3Error codes (click to expand)RuleCoderequired400076type400077minLength400078maxLength400079

  - `sender.dateOfBirth` (string, required)
    Sender’s date of birth, used for identity verification and compliance checks.Error codes (click to expand)RuleCoderequired400080type400081minLength400083maxLength400084format400082

  - `sender.occupation` (string, required)
    Sender’s occupation or professional activity.Error codes (click to expand)RuleCoderequired400088type400089minLength400090maxLength400091

  - `sender.employer` (string, required)
    Name of the sender’s employer or business activity.Error codes (click to expand)RuleCoderequired400092type400093minLength400094maxLength400095

  - `sender.proofOfIncome` (string, required)
    Description of the sender’s source of income or supporting documentation.Error codes (click to expand)RuleCoderequired400096type400097minLength400098maxLength400099

  - `beneficiary` (object, required)
    Represents the final recipient of the funds in a transaction.

 Contains the personal, identification, and location information required to validate the recipient against AML, sanctions, and regulatory screening rules.

 This object is used to ensure the payout can be legally and operationally executed in the destination country.Error codes (click to expand)RuleCoderequired400151type400152

  - `beneficiary.firstName` (string, required)
    Beneficiary’s given name.Error codes (click to expand)RuleCoderequired400153type400154minLength400155maxLength400156

  - `beneficiary.middleName` (string)
    Beneficiary’s middle name, if applicable.Error codes (click to expand)RuleCoderequired400157type400158minLength400159maxLength400160

  - `beneficiary.lastName` (string, required)
    Beneficiary’s primary family name.Error codes (click to expand)RuleCoderequired400161type400162minLength400163maxLength400164

  - `beneficiary.secondLastName` (string)
    Beneficiary’s second family name.Error codes (click to expand)RuleCoderequired400165type400166minLength400167maxLength400168

  - `beneficiary.phone` (string, required)
    Beneficiary’s phone number without country code.Error codes (click to expand)RuleCoderequired400169type400170minLength400171maxLength400172

  - `beneficiary.phoneCountryCode` (string, required)
    International dialing code of the beneficiary’s phone number.Error codes (click to expand)RuleCoderequired400173type400174minLength400175maxLength400176allowedValues400214
    Enum: "+1"

  - `beneficiary.addressStreet` (string, required)
    Beneficiary address. Structure: [Description, city name, State ISO2 zipCode, Country ISO3]. Example:'54545 Salo Rd, Hancock, MI 49930, USA' Regular expression: ^[0-9]+\s[\w\s.,-]+$Error codes (click to expand)RuleCoderequired400177type400178minLength400179maxLength400180pattern400215

  - `beneficiary.addressState` (string, required)
    Beneficiary state (ISO 2). https://en.wikipedia.org/wiki/ISO_3166-2Error codes (click to expand)RuleCoderequired400181type400182minLength400183maxLength400184allowedValues400213
    Enum: "US-AL", "US-AK", "US-AZ", "US-AR", "US-CA", "US-CO", "US-CT", "US-DE", "US-FL", "US-GA", "US-HI", "US-ID", "US-IL", "US-IN", "US-IA", "US-KS", "US-KY", "US-LA", "US-ME", "US-MD", "US-MA", "US-MI", "US-MN", "US-MS", "US-MO", "US-MT", "US-NE", "US-NV", "US-NH", "US-NJ", "US-NM", "US-NY", "US-NC", "US-ND", "US-OH", "US-OK", "US-OR", "US-PA", "US-RI", "US-SC", "US-SD", "US-TN", "US-TX", "US-UT", "US-VT", "US-VA", "US-WA", "US-WV", "US-WI", "US-WY"

  - `beneficiary.addressCity` (string, required)
    City name  of residence of the beneficiary.Error codes (click to expand)RuleCoderequired400185type400186minLength400187maxLength400188

  - `beneficiary.addressCountry` (string, required)
    Beneficiary country (ISO 3). https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3Error codes (click to expand)RuleCoderequired400189type400190minLength400191maxLength400192

  - `beneficiary.addressZipCode` (string, required)
    Postal or ZIP code of the beneficiary’s address.Error codes (click to expand)RuleCoderequired400216type400217minLength400218maxLength400219

  - `beneficiary.documentType` (string)
    Type of identification document of the beneficiary.  

Document types (documentType) — click to expandCodeDocument TypeDescriptionBDBORDER CROSSING CARDBorder crossing card used to enter certain countries without a passport.BFCPF/CNPJBrazilian tax registry for individuals (CPF) and legal entities (CNPJ).CACARTEIRA DE IDENTIDADEIdentity document issued in Brazil.CCCÉDULA CIUDADANÍAIdentification document in Colombia.CECÉDULA DE IDENTIDAD Y ELECTORALIdentity document used in the Dominican Republic.CICÉDULA DE IDENTIDADIdentity document issued in various Latin American countries.CLCREDENCIAL DE ELECTORVoter identification document used in Mexico.CNCERTIFICATE OF NATURALIZATIONNaturalization certificate that grants citizenship in the U.S. or other countries.CPCADASTRO DE PESSOAS FÍSICAS (CPF)Tax registry for individuals in Brazil.CRCREW LANDING PERMIT & BADGELanding permit for aircraft crew members.CVCÉDULA DE VECINDADIdentity document in Guatemala.CZCERTIFICATE OF CITIZENSHIPCitizenship certificate issued by national governments.DIDOCUMENTO NACIONAL DE IDENTIDAD (DNI)Identity document in Argentina, Spain, and other countries.DLDRIVER'S LICENSEDriver's license.DNDOCUMENTO NACIONALNational identity document.DUDOCUMENTO ÚNICO DE IDENTIDAD (DUI)Identity document in El Salvador.EAEMPLOYMENT AUTHORIZATIONEmployment authorization document in the U.S.GCGREEN CARDPermanent residence card in the U.S.GIGOVERNMENT IDENTIFICATIONIdentification issued by the government for its citizens.ICCÉDULA DE IDENTIDAD CIVILCivil identity document in several countries.IDIDENTIFICATION CARDGeneral identification card.LDDRIVER'S LICENSEDriver's license.LELIBRETA ELECTORALElectoral document in Peru.LPLEARNER PERMITLearner's permit for driving.MCMATRÍCULA CONSULARIdentity document issued by consulates to citizens abroad.MIMILITARY IDMilitary identification.NNNONENo identity document required.OIOFFICIAL ID (POLICE, FIRE, ETC)Official identification for police, firefighters, etc.OTOTHEROther type of identity document.PAPASSPORTPassport issued by a government.PCPASSPORT CARDPassport card used in the U.S. for certain international travel.PPPASAPORTEPassport.PRPERMANENT RESIDENT CARDPermanent residence card in some countries.RARESIDENT ALIENDocument for a foreign resident.SISTATE ISSUED IDIdentification issued by a state or province.SSSSNSocial Security Number (U.S.).TITARJETA DE IDENTIDADIdentity card in some Latin American countries.TRTARJETA DE REGISTRO CONSULARConsular registration card for citizens abroad.VIVISAEntry visa for a country.Error codes (click to expand)RuleCoderequired400193type400194minLength400195maxLength400196

  - `beneficiary.documentNumber` (string)
    Identification document number of the beneficiary.Error codes (click to expand)RuleCoderequired400197type400198minLength400199maxLength400200

  - `beneficiary.documentDescription` (string)
    Identification document number of the beneficiary.Error codes (click to expand)RuleCoderequired400201type400202minLength400203maxLength400204

  - `beneficiary.documentCountry` (string)
    Country that issued the beneficiary’s identification document.Error codes (click to expand)RuleCoderequired400205type400206minLength400207maxLength400208

  - `beneficiary.relationShip` (string)
    Relationship between sender and beneficiary (e.g., Family, Friend, Business).Error codes (click to expand)RuleCoderequired400209type400210minLength400211maxLength400212

  - `transactionInformation` (object, required)
    Represents the financial, operational, and processing configuration of the transaction.

Contains all parameters required to calculate, validate, route, and execute the transfer, including amounts, currencies, delivery method, funding source, fees, and payout instructions.

All fields are validated against business rules, compliance policies, and operational constraints before the transaction is accepted for processing.Error codes (click to expand)RuleCoderequired400301type400302

  - `transactionInformation.deliveryMode` (string, required)
    Defines the payout execution method and destination details for the transaction.

Specifies how and where the funds will be delivered to the beneficiary (e.g., cash pickup, bank deposit, walletcredit, or home delivery), including all routing and operational parameters required to complete the payout.

 Delivery mode     Code Delivery Mode Description     P Cash Pickup Cash withdrawal at an authorized location.   C Bank Deposit Direct deposit to a bank account.   O Mobile Wallet Deposit to a mobile wallet.   D Home Delivery Cash delivered to the recipient’s address.   U Undefined Undefined    Error codes (click to expand)RuleCoderequired400303type400304minLength400305maxLength400306allowedValues400307
    Enum: "C"

  - `transactionInformation.deliveryModeDetails` (object, required)
    Contains the bank account and routing information required to execute the payout to the beneficiary.

This object defines the destination financial institution and account where the funds will be deposited, including account number, account type, routing number, and bank details.

All fields are validated against country-specific banking rules and payout network requirements before the transaction is released for payment.Error codes (click to expand)RuleCoderequired400308type400309

  - `transactionInformation.deliveryModeDetails.accountNumber` (string, required)
    Destination account number.Error codes (click to expand)RuleCoderequired400310type400311minLength400312maxLength400313

  - `transactionInformation.deliveryModeDetails.accountAuxiliaryField` (string)
    Error codes (click to expand)RuleCoderequired400314type400315minLength400316maxLength400317

  - `transactionInformation.deliveryModeDetails.accountType` (string)
    Delivery mode used for the transaction.Account typesCodeAccount TypeDescriptionSSavingSavings accountCCheckingChecking accountUUndefinedUndefinedError codes (click to expand)RuleCoderequired400318type400319minLength400320maxLength400321allowedValues400388
    Enum: "S", "C"

  - `transactionInformation.deliveryModeDetails.routingNumber` (string, required)
    Bank routing or clearing numberError codes (click to expand)RuleCoderequired400407type400408minLength400409maxLength400410

  - `transactionInformation.deliveryModeDetails.bank` (string, required)
    Name of the receiving bank.Error codes (click to expand)RuleCoderequired400411type400412minLength400413maxLength400414

  - `transactionInformation.funding` (object, required)
    Defines the source of funds and funding method used to initiate the transaction.

Contains the payment instrument and funding configuration (e.g., cash, debit card, bank account, wallet), and is used to validate, authorize, and register the financial charge before the transaction is processed.Error codes (click to expand)RuleCoderequired400322type400323

  - `transactionInformation.funding.type` (string, required)
    Funding source type (e.g., bank account, cash, etc.). 

 Funding types    Code Funding Type Description     A Account bank Indicates that the transaction is funded directly from a bank account. The funds will be debited from the specified bank account using the configured banking or payment network before the transaction is processed.   C Cash Indicates that the transaction is funded using cash. The sender provides the funds in cash at an authorized agent location or branch before the transaction is processed.    Error codes (click to expand)RuleCoderequired400324type400325minLength400326maxLength400327allowedValues400406
    Enum: "A", "C"

  - `transactionInformation.funding.accountNumber` (string, required)
    Funding account number.Error codes (click to expand)RuleCoderequired400420type400421minLength400422maxLength400423

  - `transactionInformation.funding.routingNumber` (string, required)
    Routing number bank.Error codes (click to expand)RuleCoderequired400424type400425minLength400426maxLength400427

  - `transactionInformation.originationCountryISO` (string, required)
    Origin country (ISO 3). https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3Error codes (click to expand)RuleCoderequired400328type400329minLength400330maxLength400331allowedValues400391
    Enum: "TCD", "COL", "DOM", "COD", "GNB", "HTI", "JAM", "MEX", "MAR", "MOZ", "NER", "PAK", "PHL", "TUR", "ALB", "BOL", "CMR", "CAF", "CRI", "ECU", "SLV", "GHA", "GTM", "HND", "IDN", "KEN", "KGZ", "LBR", "MLI", "MRT", "NIC", "NGA", "PER", "SEN", "TZA", "THA", "AND", "ARG", "AUS", "AUT", "AZE", "BGD", "BEL", "BEN", "BIH", "BRA", "BGR", "BFA", "CAN", "CHL", "COG", "HRV", "CYP", "CZE", "DNK", "ERI", "EST", "SWZ", "FIN", "FRA", "GAB", "GMB", "GEO", "DEU", "GIB", "GRC", "GIN", "HKG", "HUN", "ISL", "IND", "IRL", "ITA", "CIV", "LVA", "LIE", "LTU", "LUX", "MDG", "MYS", "MLT", "MCO", "NPL", "NLD", "NZL", "NOR", "POL", "PRT", "ROU", "RWA", "SMR", "SLE", "SVK", "SVN", "KOR", "ESP", "LKA", "SWE", "CHE", "TGO", "UGA", "GBR", "USA", "URY", "VNM", "ZMB"

  - `transactionInformation.originationStateISO` (string, required)
    Origin state (ISO 2). https://en.wikipedia.org/wiki/ISO_3166-2Error codes (click to expand)RuleCoderequired400332type400333minLength400334maxLength400335

  - `transactionInformation.originationLocationCity` (string, required)
    City where the transaction is initiated.Error codes (click to expand)RuleCoderequired400336type400337minLength400338maxLength400339

  - `transactionInformation.originationAmount` (number, required)
    Amount of money sent in the origination currency.Error codes (click to expand)RuleCoderequired400340type400341minimum400398decimal400399

  - `transactionInformation.originationCurrencyISO` (string, required)
    Origin currency (ISO). https://en.wikipedia.org/wiki/ISO_4217Error codes (click to expand)RuleCoderequired400342type400343minLength400344maxLength400345allowedValues400392
    Enum: "MXN"

  - `transactionInformation.exchangeRate` (number)
    Amount of money sent in the origination currency.Error codes (click to expand)RuleCoderequired400346type400347minimum400400decimal400401

  - `transactionInformation.fee` (number)
    Transaction service fee charged for processing the remittance.Error codes (click to expand)RuleCoderequired400348type400349minimum400402decimal400403

  - `transactionInformation.deliveryCountryISO` (string, required)
    Delivery country (ISO 3). https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3Error codes (click to expand)RuleCoderequired400350type400351minLength400352maxLength400353allowedValues400393
    Enum: "USA"

  - `transactionInformation.deliveryStateISO` (string, required)
    Delivery state (ISO 2). https://en.wikipedia.org/wiki/ISO_3166-2Error codes (click to expand)RuleCoderequired400354type400355minLength400356maxLength400357allowedValues400395
    Enum: "US-AL", "US-AK", "US-AZ", "US-AR", "US-CA", "US-CO", "US-CT", "US-DE", "US-FL", "US-GA", "US-HI", "US-ID", "US-IL", "US-IN", "US-IA", "US-KS", "US-KY", "US-LA", "US-ME", "US-MD", "US-MA", "US-MI", "US-MN", "US-MS", "US-MO", "US-MT", "US-NE", "US-NV", "US-NH", "US-NJ", "US-NM", "US-NY", "US-NC", "US-ND", "US-OH", "US-OK", "US-OR", "US-PA", "US-RI", "US-SC", "US-SD", "US-TN", "US-TX", "US-UT", "US-VT", "US-VA", "US-WA", "US-WV", "US-WI", "US-WY"

  - `transactionInformation.deliveryAmount` (number)
    Amount to be delivered in the destination currency.Error codes (click to expand)RuleCoderequired400358type400359minimum400404decimal400405

  - `transactionInformation.deliveryAmountCurrencyISO` (string, required)
    Delivery currency (ISO). https://en.wikipedia.org/wiki/ISO_4217Error codes (click to expand)RuleCoderequired400360type400361minLength400362maxLength400363allowedValues400394
    Enum: "USD"

  - `transactionInformation.deliveryLocationCode` (string, required)
    Internal or partner code of the payout location.Error codes (click to expand)RuleCoderequired400364type400365minLength400366maxLength400367allowedValues400389
    Enum: "T377"

  - `transactionInformation.deliveryLocationNetwork` (string, required)
    Network or partner identifier used for payout.Error codes (click to expand)RuleCoderequired400368type400369minLength400370maxLength400371allowedValues400390
    Enum: "PV0001"

  - `transactionInformation.deliveryLocationName` (string, required)
    Human-readable name of the payout location or method.Error codes (click to expand)RuleCoderequired400372type400373minLength400374maxLength400375

  - `transactionInformation.deliveryLocationCity` (string, required)
    City where the funds will be delivered.Error codes (click to expand)RuleCoderequired400376type400377minLength400378maxLength400379

  - `transactionInformation.sourceOfFounds` (string)
    Declared source of funds used to finance the remittance (e.g., salary, savings, business income). This information may be required for compliance (KYC/AML) depending on the client configuration, corridor, or transaction amount thresholds.Error codes (click to expand)RuleCoderequired400380type400381minLength400382maxLength400383

  - `transactionInformation.remittancePurpose` (string)
    Declared purpose of the remittance, describing why the funds are being sent (e.g., family support, education, medical expenses, rent, personal transfer). This can be used for compliance classification, reporting, and corridor-specific regulatory requirements.Error codes (click to expand)RuleCoderequired400384type400385minLength400386maxLength400387

  - `channel` (string)
    Identifies the integration channel used to create the transaction (API, Web, Messaging, etc.).Error codes (click to expand)RuleCoderequired400501type400502minLength400503maxLength400504allowedValues400507
    Enum: "API", "WHATSAPP"

  - `channelMetadata` (object)
    Dynamic / Data considered relevant by the client for informational purposes for internal trackingError codes (click to expand)RuleCoderequired400505type400506

## Response 200 fields (application/json):

  - `status` (string)
    Request status (success, error, etc.).

  - `message` (string)
    Descriptive message about the operation result.

  - `transaction_id` (string)
    Unique identifier of the generated transaction.

  - `transaction_uuid` (string)
    Unique identifier of the generated transaction.

  - `status_track_url` (string)
    URL where the user can track the transaction.

  - `folio` (string)
    Money transfer tracking number.

  - `total_receiver` (string)
    Amount in destination currency that the customer is sending plus fees.

  - `total_pay_receiver` (string)
    Amount in destination currency that the beneficiary is receiving.

  - `rate` (string)
    Exchange rate.

  - `source_currency_amount` (string)
    Amount in source currency that the customer is sending.

## Response 400 fields (application/json):

  - `errors` (array)
    List of object errorsError catalog for 400 (click to expand)   Code Description     400000  The body of the request is required  Invalid JSON format of the request body    400001  client_id is required    400005  secret_key is required    400415  The routing number 'routingNumber' is not valid.

  - `errors.status` (string)

  - `errors.code` (number)

  - `errors.message` (string)

  - `errors.details` (string)

## Response 401 fields (application/json):

  - `errors` (array)
    List of object errorsError catalog for 401 (click to expand)   Code Description     401000 Invalid credentials

  - `errors.status` (string)

  - `errors.code` (number)

  - `errors.message` (string)

  - `errors.details` (string)

## Response 404 fields (application/json):

  - `errors` (array)
    List of object errorsError catalog for 404 (click to expand)   Code Description     404001 Sender not found   404002 Beneficiary does not belong to this sender

  - `errors.status` (string)

  - `errors.code` (number)

  - `errors.message` (string)

  - `errors.details` (string)

## Response 422 fields (application/json):

  - `errors` (array)
    List of object errorsError catalog for 422 (click to expand)   Code Description     422001 The agency credit limit has been exceeded or is insufficient to process this transaction.   422002 The service is temporarily unable to process transactions with the origination currency.   422003 Viamericas is unable to process a transaction for this customer/beneficiary

  - `errors.status` (string)

  - `errors.code` (number)

  - `errors.message` (string)

  - `errors.details` (string)

## Response 500 fields (application/json):

  - `errors` (array)
    List of object errorsError catalog for 500 (click to expand)   Code Description     500000 Internal Error   500001 Sender creation failed   500002 Beneficiary creation failed   500003 Transaction creation failed   500004 Payment link creation failed   500005 Compliance engine validation failed

  - `errors.status` (string)

  - `errors.code` (number)

  - `errors.message` (string)

  - `errors.details` (string)