Schemas
Data models used by the Payment API.
AccessToken
objecttoken_typeRequiredstringexpires_inRequiredintegeraccess_tokenRequiredstringscopeRequiredstringCurrency
stringCurrency code — ISO 4217 (e.g. USD, EUR) or a supported digital currency (USDT, USDC).
FiatCurrency
stringISO 4217 fiat currency used for local payout. Digital currencies are not valid buy currencies.
CountryCode
stringISO 3166-1 alpha-2 country code.
Decimal
stringDecimal number serialized as a string to preserve precision.
Money
objectFiatMoney
objectamountRequiredDecimalcurrencyRequiredFiatCurrencyPageInfo
objecthasNextPageRequiredbooleanWhen paginating forwards, are there more items?
endCursorstringWhen paginating forwards, the cursor to continue.
PaymentRailsCode
stringPayment rail code the account settles on (e.g. `ZENUS_BANK`, `TRON`).
AccountStatus
stringACTIVESUSPENDEDCLOSEDAccount
objectAn Axiym account that holds one currency on one payment rail. Its available balance funds payments. Account funding is arranged outside the Payment API.
accountIdRequiredstringAccount identifier (UUID).
currencyRequiredCurrencyAccount currency.
paymentRailsRequiredPaymentRailsCodeRail the account settles on.
balanceRequiredDecimalCurrent balance.
statusRequiredAccountStatusAccount status.
StatementEntryType
stringDirection of movement on the account.
CREDITDEBITStatementEntry
objectA posted ledger movement on an account. Entries are returned in posting order and carry the running balance, so consecutive entries reconcile against each other.
entryIdRequiredstringLedger entry identifier (UUID).
accountIdRequiredstringAccount identifier (UUID).
typeRequiredStatementEntryTypeCredit or debit direction.
amountRequiredDecimalPositive movement amount in the account currency; direction is in `type`.
currencyRequiredCurrencyAccount currency.
balanceBeforeDecimalRunning balance before this movement.
balanceAfterRequiredDecimalRunning balance after this movement.
relatedResourceTypestringType of the linked money movement; absent for ledger adjustments with no linked resource.
DEPOSITWITHDRAWALCONVERSIONPAYOUTrelatedResourceIdstringIdentifier of the linked resource, where present.
occurredAtRequiredstringWhen the movement occurred. Formatted in ISO 8601.
Corridor
objectA configured payout route from the partner's onboarded origin country and sell currency to a destination country, buy currency, and payout method.
originCountryRequiredCountryCodeDerived from the partner's onboarded location.
sellCurrencyRequiredCurrencyCurrency sold from the funding account.
destinationCountryRequiredCountryCodeDestination country for the payout.
buyCurrencyRequiredFiatCurrencyFiat currency bought and delivered to the receiver.
payoutMethodRequiredPayoutMethodMethod used to deliver the payout.
availabilityRequiredCorridorAvailabilityCurrent availability of the payout route.
CorridorAvailability
stringCurrent availability of the corridor. A payout quote can only be created when the corridor is AVAILABLE.
AVAILABLEUNAVAILABLECorridorDetails
Corridor & objectCorridorobjectCorridorAmountLimits
objectPermitted payout range expressed in the corridor's buy currency. A quote outside this range is rejected.
PayoutMethod
stringMethod used to deliver the payout. Currently only bank payouts are supported.
BANKQuoteRequest
objectaccountIdRequiredstringA funded Axiym account enabled for payouts. The sell currency is derived from this account.
buyCurrencyRequiredFiatCurrencyFiat currency to deliver to the receiver.
destinationCountryRequiredCountryCodeDestination country for the payout.
payoutMethodRequiredPayoutMethodamountRequiredDecimalAmount expressed in the currency selected by amountBasis.
amountBasisRequiredstringIndicates whether amount is expressed in the sell or buy currency.
sellbuyQuoteStatus
stringACTIVEEXPIREDUSEDCANCELEDExchangeRate
objectQuote
objectquoteIdRequiredstringaccountIdRequiredstringstatusRequiredQuoteStatusoriginCountryRequiredCountryCodeDerived from the partner's onboarded location.
destinationCountryRequiredCountryCodepayoutMethodRequiredPayoutMethodsellRequiredMoneyAmount sold from the funding account currency, excluding the fee.
buyRequiredFiatMoneyAmount bought and delivered to the beneficiary.
feeRequiredMoneytotalPayableRequiredMoneyTotal amount payable from the funding account, including the fee.
rateRequiredExchangeRaterequestedAtRequiredstringexpiresAtRequiredstringCorridorRequirements
objectCountry-playbook additions and overrides for the corridor. This does not repeat fields that are required for every payout.
fieldsRequiredCorridorFieldRequirement[]Fields whose requiredness, format, validation or normalization is specific to this corridor.
complianceInformationRequiredstring[]Destination-specific compliance information that may affect the payout data Axiym validates.
CorridorFieldRequirement
objectfieldRequiredstringPartner-facing payment-data field path.
labelRequiredstringHuman-readable field name.
requirednessRequiredstringRequiredness for this corridor.
REQUIREDOPTIONALformatRequiredstringHuman-readable value format.
patternstringRegular expression used to validate the value when one applies.
normalizationstringNormalization applied before validation when one applies.
descriptionRequiredstringAdditional guidance for supplying the field.
PartyAddress
objectPartyContact
objectemailRequiredstringphoneNumberRequiredstringInternational phone number in E.164 format.
PartyIdentificationType
stringPartner-facing classification of a party identification document or identifier. Corridor requirements determine which types are accepted for a specific payout.
REGISTRATION_NUMBERTAX_IDVAT_NUMBERNATIONAL_IDPASSPORTDRIVER_LICENSERESIDENCE_PERMITLEIOTHERPartyIdentification
objecttypeRequiredPartyIdentificationTypenumberRequiredstringcountryCountryCodeissueDatestringexpiryDatestringPartyIdentificationInput
objectIdentification data supplied while preparing a payout. The type value is normalized to Axiym's closed PartyIdentificationType vocabulary for the prepared instruction.
typeRequiredstringHow you describe the identification type. Provide an accepted Axiym value or descriptive text; Axiym normalizes it before validation.
numberRequiredstringcountryCountryCodeissueDatestringexpiryDatestringUboDesignation
stringRelationship of the individual to the sender. Every entry in the sender.ubos array represents an ultimate beneficial owner.
uboUltimateBeneficialOwner
objectfirstNameRequiredstringlastNameRequiredstringdesignationRequiredUboDesignationnationalitiesRequiredCountryCode[]addressRequiredPartyAddressidRequiredPartyIdentificationUltimateBeneficialOwnerInput
objectfirstNameRequiredstringlastNameRequiredstringdesignationRequiredstringHow you describe the individual's ownership or control relationship. Axiym normalizes it to the final UBO designation before validation.
nationalitiesRequiredCountryCode[]addressRequiredPartyAddressidRequiredPartyIdentificationInputAxiymSender
objectThe normalized sender returned with a prepared payout. Fields with an allowed-value list contain their final Axiym values.
nameRequiredstringcountryOfIncorporationRequiredCountryCodeaddressRequiredPartyAddresscontactRequiredPartyContactidRequiredPartyIdentificationubosRequiredUltimateBeneficialOwner[]AxiymSenderInput
objectSender data using Axiym's field structure. Fields with an allowed-value list may use descriptive partner terms; Axiym normalizes them before validation.
nameRequiredstringcountryOfIncorporationRequiredCountryCodeaddressRequiredPartyAddresscontactRequiredPartyContactidRequiredPartyIdentificationInputubosRequiredUltimateBeneficialOwnerInput[]BankAccountType
stringFunctional type of the receiver's destination bank account.
CURRENTSAVINGSCHECKINGCORPORATEOTHERReceiverBankAccount
objectThe normalized destination bank account returned with a prepared payout. Axiym derives the clearing system and account currency.
accountHolderNameRequiredstringaccountTypeRequiredBankAccountTypeaccountNumberRequiredstringnameRequiredstringcountryRequiredCountryCodebicstringISO 9362 BIC, when required for the corridor.
clearingCodestringLocal clearing or routing code, when required for the corridor.
ReceiverBankAccountInput
objectDestination bank-account details. `accountType` may use descriptive partner terms and is normalized before validation. Axiym derives the clearing system and account currency.
accountHolderNameRequiredstringaccountTypeRequiredstringHow you describe the bank-account type. Provide an accepted Axiym value or descriptive text; Axiym normalizes it before validation.
accountNumberRequiredstringnameRequiredstringcountryRequiredCountryCodebicstringISO 9362 BIC, when required for the corridor.
clearingCodestringLocal clearing or routing code, when required for the corridor.
ReceiverRelationship
stringProvider-neutral business relationship between the receiver and sender.
SUPPLIERCUSTOMERCONTRACTORSERVICE_PROVIDERGROUP_COMPANYSUBSIDIARYPARENTINVESTMENT_TARGETDEBTORCREDITOROTHERAxiymReceiver
objectThe normalized receiver returned with a prepared payout. Fields with an allowed-value list contain their final Axiym values. The corridor determines any extra identification and routing requirements.
nameRequiredstringcountryOfIncorporationRequiredCountryCoderelationshipRequiredReceiverRelationshipaddressRequiredPartyAddresscontactRequiredPartyContactbankRequiredReceiverBankAccountAxiymReceiverInput
objectReceiver data using Axiym's field structure. Fields with an allowed-value list may use descriptive partner terms; Axiym normalizes them before validation. The corridor determines any extra identification and routing requirements.
nameRequiredstringcountryOfIncorporationRequiredCountryCoderelationshipRequiredstringHow you describe the receiver's relationship to the sender. Provide an accepted Axiym value or descriptive text; Axiym normalizes it before validation.
addressRequiredPartyAddresscontactRequiredPartyContactbankRequiredReceiverBankAccountInputPartyDataMapDefinition
objectPortable, partner-independent mapping definition exported by the Payload Mapping Tool. It contains field paths, but no partner identifier, sample party values, or enum translations.
schemaVersionRequiredstringVersion of the portable party-data-map document format.
targetModelVersionRequiredstringVersion of Axiym's partner-facing party fields used when the map was authored.
senderRequiredPartyDataMapSectionreceiverRequiredPartyDataMapSectionPartyDataMapSection
objectDeclarative field mappings for one party object. Source paths use the partner's JSON structure; target paths use Axiym's documented sender or receiver structure.
mappingsRequiredobjectSource paths keyed to their Axiym target paths. Array paths use `[]`, for example `owners[].fullName`.
CreatePartyDataMapRequest
objectnameRequiredstringPartner-facing name for the stored map.
descriptionstringOptional note describing the source structures or integration that uses this map.
definitionRequiredPartyDataMapDefinitionPartyDataMapStatus
stringLifecycle state of a stored party data map.
ACTIVEARCHIVEDPartyDataMap
objectImmutable party data map stored for the authenticated partnership.
partyDataMapIdRequiredstringnameRequiredstringdescriptionstringdefinitionRequiredPartyDataMapDefinitionversionRequiredintegerStored resource version. A changed definition is stored as a new immutable party data map.
statusRequiredPartyDataMapStatuscontentHashRequiredstringSHA-256 digest of Axiym's canonical serialization of the map definition.
createdAtRequiredstringPartyDataMapPage
objectnodesRequiredPartyDataMap[]pageInfoRequiredPageInfoMappedPartyData
objectSender or receiver data using the partner-defined structure linked to `partyDataMapId`. The saved map translates field paths. Axiym then normalizes allowed-value fields and validates the result using the same party-data requirements.
allowedSupportingDocumentType
stringAxiym classification of evidence supplied with a payout.
PASSPORTNATIONAL_IDDRIVER_LICENSERESIDENCE_PERMITPROOF_OF_ADDRESSUTILITY_BILLBANK_STATEMENTTAX_CERTIFICATECERTIFICATE_OF_INCORPORATIONREGISTRY_EXTRACTARTICLES_OF_ASSOCIATIONSHAREHOLDER_REGISTERDIRECTOR_REGISTERUBO_DECLARATIONPOWER_OF_ATTORNEYBOARD_RESOLUTIONREGULATORY_LICENSEBUSINESS_LICENSEFINANCIAL_STATEMENTAUDIT_REPORTSOURCE_OF_FUNDSINVOICECONTRACTPURCHASE_ORDERPAYROLL_FILELOAN_AGREEMENTSHIPPING_DOCUMENTCUSTOMS_DECLARATIONOTHERTransactionPurpose
stringAxiym's classification of the business reason for the payment.
GOODS_PURCHASESERVICES_PAYMENTSALARY_PAYROLLCONTRACTOR_PAYMENTRENT_LEASELOAN_DISBURSEMENTLOAN_REPAYMENTINTERCOMPANY_TRANSFERTREASURY_MANAGEMENTTAX_PAYMENTINVESTMENTREFUNDOTHERSourceOfFunds
stringAxiym's classification of where the payment funds originated.
BUSINESS_REVENUEBANK_ACCOUNT_BALANCESAVINGSSALARY_INCOMEINVESTMENT_PROCEEDSSALE_OF_ASSETLOAN_PROCEEDSCAPITAL_CONTRIBUTIONSHAREHOLDER_FUNDSGRANT_OR_DONATIONINHERITANCEOTHERSupportingDocumentInput
objectSupporting evidence supplied while preparing a payout. The document type is normalized to Axiym's closed SupportingDocumentType vocabulary for the prepared instruction.
documentTypeRequiredstringHow you describe the supporting document. Provide an accepted Axiym value or descriptive text; Axiym normalizes it before validation.
documentDescriptionstringdocumentContentTypeRequiredstringdocumentDataRequiredstringdocumentDataBacksidestringTransactionInput
objectTransaction details and supporting evidence for the payment. Purpose, source of funds, and document types may use descriptive partner terms; Axiym normalizes them before validation.
purposeRequiredstringThe business reason for the payment. Provide an accepted Axiym value or descriptive text; Axiym normalizes it before validation.
sourceOfFundsRequiredstringWhere the payment funds originated. Provide an accepted Axiym value or descriptive text; Axiym normalizes it before validation.
referencestringsupportingDocumentsRequiredSupportingDocumentInput[]AxiymPartyPayoutRequest
objectUse this variant when `sender` and `receiver` follow Axiym's documented field structure. Do not provide `partyDataMapId`. Axiym normalizes allowed-value fields before validation.
quoteIdRequiredstringclientReferenceRequiredstringPartner's unique, idempotent reference to the payout.
transactionRequiredTransactionInputsenderRequiredAxiymSenderInputreceiverRequiredAxiymReceiverInputMappedPartyPayoutRequest
objectUse this variant when `sender` and `receiver` follow the partner-defined structures linked to `partyDataMapId`. The saved map translates party-field paths. `transaction` still uses Axiym's structure, and Axiym normalizes allowed-value fields before validation.
quoteIdRequiredstringclientReferenceRequiredstringPartner's unique, idempotent reference to the payout.
partyDataMapIdRequiredstringImmutable saved mapping applied to sender and receiver only.
transactionRequiredTransactionInputsenderRequiredMappedPartyDatareceiverRequiredMappedPartyDataPayoutRequest
AxiymPartyPayoutRequest | MappedPartyPayoutRequestChoose one party-data mode. Without `partyDataMapId`, use Axiym's documented `sender` and `receiver` structure. With `partyDataMapId`, use the partner structures linked to that map. Both modes normalize allowed-value fields and apply the same payment and corridor validation.
PayoutTestContext
objectNon-financial context used to select the applicable destination requirements. Axiym derives the origin country from the partner's onboarded location.
sellCurrencyRequiredCurrencyCurrency that would fund the payment.
destinationCountryRequiredCountryCodeCountry where the beneficiary would be paid.
buyCurrencyRequiredFiatCurrencyLocal fiat currency that would be delivered to the beneficiary.
payoutMethodRequiredPayoutMethodAxiymPayoutTestRequest
objectTests a complete representative payload whose sender and receiver already use Axiym's documented field structure.
contextRequiredPayoutTestContexttransactionRequiredTransactionInputsenderRequiredAxiymSenderInputreceiverRequiredAxiymReceiverInputMappedPayoutTestRequest
objectTests a complete representative payload after applying the stored Party Data Map to sender and receiver. Transaction data continues to use Axiym's documented structure.
contextRequiredPayoutTestContextpartyDataMapIdRequiredstringStored Party Data Map applied to the representative sender and receiver objects.
transactionRequiredTransactionInputsenderRequiredMappedPartyDatareceiverRequiredMappedPartyDataPayoutTestRequest
AxiymPayoutTestRequest | MappedPayoutTestRequestRepresentative payout data used to test party structure, optional Party Data Map application, controlled-value normalization, and destination-specific validation without creating a quote or payout. `clientReference` is omitted because no resource is created.
PayoutTestResult
objectNormalized representative payout data and its validation result. Nothing in this response is a quote or payout instruction, and no submitted payload data is persisted.
validRequiredbooleanTrue when the mapped and normalized payload satisfies the baseline and destination requirements selected by context.
contextRequiredPayoutTestContextpartyDataMapIdstringParty Data Map used by the test. Omitted when the submitted parties used Axiym's structure.
normalizedDataRequiredPayoutTestNormalizedDatanormalizationsRequiredPayoutTestNormalization[]Controlled values changed during normalization. Exact Axiym values that passed through unchanged are not included.
warningsRequiredPayoutTestWarning[]Non-blocking mapping or validation observations, such as unused source fields.
errorsRequiredobject | nullMapping or validation failures keyed by the mapped payout-data path; null when `valid` is true.
PayoutTestNormalizedData
objectMapped and normalized sender, receiver, and transaction data produced during a test. It can be incomplete when validation fails, so it is less restrictive than `PreparedPaymentData`.
senderRequiredobjectreceiverRequiredobjecttransactionRequiredobjectPayoutTestNormalization
objectOne supplied value that was normalized to a controlled Axiym value during the test.
pathRequiredstringAxiym payout-data path containing the normalized value.
inputValueRequiredstringnormalizedValueRequiredstringFinal allowed Axiym value.
vocabularyRequiredstringControlled vocabulary used for normalization.
PayoutTestWarning
objectcodeRequiredstringpathstringPartner source path or mapped Axiym path associated with the warning.
messageRequiredstringPayoutStatus
stringNormalized payout lifecycle status. PENDING_CONFIRMATION means the prepared payout has not yet been committed and cannot move funds or be submitted for execution.
PENDING_CONFIRMATIONPROCESSINGAPPROVEDSETTLEDSUBMITTEDCOMPLETEDREJECTEDFAILEDRETURNEDCANCELEDEXPIREDPayout
objectpayoutIdRequiredstringquoteIdRequiredstringaccountIdRequiredstringclientReferenceRequiredstringstatusRequiredPayoutStatuspayoutMethodRequiredPayoutMethodsellRequiredMoneyAmount sold from the funding account currency, excluding the fee.
buyRequiredFiatMoneyAmount bought and delivered to the beneficiary.
feeRequiredMoneytotalPayableRequiredMoneyTotal amount payable from the funding account, including the fee.
confirmationExpiresAtRequiredstringDeadline for confirming a payout with status PENDING_CONFIRMATION. Derived from the referenced quote's expiry.
confirmedAtstringPresent after the partner has confirmed the prepared payout.
failurePayoutFailurecreatedAtRequiredstringupdatedAtRequiredstringPayoutDetails
Payout & objectA payment with its prepared party and transaction data. `paymentData` contains the normalized instruction that confirmation commits.
PayoutobjectPreparedPaymentData
objectPreparedTransactionData
objectpurposeRequiredTransactionPurposesourceOfFundsRequiredSourceOfFundsreferencestringsupportingDocumentsRequiredPreparedSupportingDocument[]PreparedSupportingDocument
objectdocumentTypeRequiredSupportingDocumentTypedocumentDescriptionstringdocumentContentTypeRequiredstringsha256RequiredstringSHA-256 digest of the decoded document content. The API does not echo base64 document data in payout responses.
hasBacksideRequiredbooleanIndicates whether backside document content was supplied.
PayoutFailure
objectcodeRequiredstringmessageRequiredstringCreateSubscriptionRequest
objectendpointRequiredstringURL of the endpoint to subscribe to notifications. Must be publicly accessible, use HTTPS, and respond with a 2XX status to a POST request.
Subscription
objectsubscriptionIdRequiredstringSubscription identifier (UUID).
endpointRequiredstringURL of the endpoint to subscribe to notifications. Must be publicly accessible, use HTTPS, and respond with a 2XX status to a POST request.
RequestStatus
objectstatusRequiredstringRequest status.
OKDefault OK
PublicKey
objectpublicKeyIdRequiredstringPublic key identifier (UUID).
activeRequiredbooleanIndicates whether the key is active
algorithmRequiredstringEncryption algorithm
publicKeyRequiredstringPublic Key
createdAtRequiredstringCreation timestamp. Formatted in ISO 8601.
Error
objectcodeRequiredintegerHTTP status code, duplicated in the body.
messageRequiredstringHuman-readable message describing the error.
errorsRequiredobject | nullAdditional error details; null when there are none.
ValidationErrorResponse
objectcodeRequiredintegerHTTP status code, duplicated in the body.
messageRequiredstringInvalid Parameters for validation failures; the rejection reason otherwise.
errorsRequiredobject | nullValidation failures are keyed by field name. Business rejections return null.
ValidationFieldErrors
ValidationError[] | objectNested validation errors keyed by field name or array index. Leaf values are arrays of `ValidationError` objects.
ValidationError[]objectValidationError
objectOne field-level validation error.
codeRequiredstringValidation rule code (e.g. 'length', 'email', 'invalid_currency', 'disbursement_account_required').
messagestring | nullHuman-readable message.
paramsRequiredobjectRule-specific parameters. Always includes `value` (the offending input). Additional keys depend on the rule (e.g. `min`, `max` for length).
valueunknownThe submitted value that failed validation.