# Schemas

Data models used by the Payment API.

Product: Payment API
API reference version: 0.1.0 (current)
OpenAPI contract: https://docs.axiym.io/openapi/payment-api/0.1.0.yaml
Canonical page: https://docs.axiym.io/payment-api/api-reference/0.1.0/schemas

[Complete reference with related definitions](/payment-api/api-reference/0.1.0/schemas.full.md)

Fetch individual schemas as needed. Each export preserves the original schema and links to related types.

- [AccessToken](/payment-api/api-reference/0.1.0/schemas/AccessToken.md)
- [Currency](/payment-api/api-reference/0.1.0/schemas/Currency.md): Currency code — ISO 4217 (e.g. USD, EUR) or a supported digital currency (USDT, USDC).
- [CountryCode](/payment-api/api-reference/0.1.0/schemas/CountryCode.md): ISO 3166-1 alpha-2 country code.
- [Decimal](/payment-api/api-reference/0.1.0/schemas/Decimal.md): Decimal number serialized as a string to preserve precision.
- [Money](/payment-api/api-reference/0.1.0/schemas/Money.md): Monetary amount and its currency.
- [PageInfo](/payment-api/api-reference/0.1.0/schemas/PageInfo.md): Cursor information for a paginated response.
- [PaymentRailsCode](/payment-api/api-reference/0.1.0/schemas/PaymentRailsCode.md): Code identifying the payment rail connected to the Axiym account, such as `ZENUS_BANK` or `TRON`. This is separate from the method used to deliver a payout.
- [AccountStatus](/payment-api/api-reference/0.1.0/schemas/AccountStatus.md): Current availability of an Axiym account.
- [Account](/payment-api/api-reference/0.1.0/schemas/Account.md): An account holding a currency balance. Receiving details for funding it are served by the deposit instructions.
- [StatementEntryType](/payment-api/api-reference/0.1.0/schemas/StatementEntryType.md): Direction of movement on the account.
- [StatementEntry](/payment-api/api-reference/0.1.0/schemas/StatementEntry.md): A posted ledger movement on an account. Entries are returned in posting order and carry the running balance, so consecutive entries reconcile against each other.
- [Corridor](/payment-api/api-reference/0.1.0/schemas/Corridor.md): A payment route defined by the funding currency, destination country, and destination currency.
- [CorridorAvailability](/payment-api/api-reference/0.1.0/schemas/CorridorAvailability.md): Current corridor availability. A payout can be created only when the corridor is `AVAILABLE`.
- [CorridorDetails](/payment-api/api-reference/0.1.0/schemas/CorridorDetails.md)
- [CorridorAmountLimits](/payment-api/api-reference/0.1.0/schemas/CorridorAmountLimits.md): Permitted amount-to-receive range in the destination currency (`destinationCurrency`). Payout creation is rejected when the target amount is outside this range.
- [CorridorRequirements](/payment-api/api-reference/0.1.0/schemas/CorridorRequirements.md): Additional field requirements and constraints for the selected corridor. Apply these alongside the baseline payout schemas.
- [CorridorFieldRequirement](/payment-api/api-reference/0.1.0/schemas/CorridorFieldRequirement.md): Corridor-specific requirement for one payment-instruction field.
- [PartyAddress](/payment-api/api-reference/0.1.0/schemas/PartyAddress.md): Structured postal address. `streetName` accepts the full primary address line; a separate `buildingNumber` is optional. See the field descriptions for supported address forms.
- [PartyContact](/payment-api/api-reference/0.1.0/schemas/PartyContact.md): Contact details for a sender, recipient, or related individual.
- [PartyIdentificationType](/payment-api/api-reference/0.1.0/schemas/PartyIdentificationType.md): Identification document or identifier type. The corridor determines which types are accepted.
- [PartyIdentification](/payment-api/api-reference/0.1.0/schemas/PartyIdentification.md): Identification details returned in the prepared payment instruction.
- [PartyIdentificationInput](/payment-api/api-reference/0.1.0/schemas/PartyIdentificationInput.md): Identification details supplied for a payment, using an exact Axiym identification type code.
- [BusinessRelationship](/payment-api/api-reference/0.1.0/schemas/BusinessRelationship.md): Relationship of the recipient to the sender.
- [PartyInput](/payment-api/api-reference/0.1.0/schemas/PartyInput.md): Sender or recipient details in Axiym's field structure, using exact controlled-value codes. Other labels require saved translations on the mapped endpoint.
- [Party](/payment-api/api-reference/0.1.0/schemas/Party.md): Sender or recipient details returned with the payout, using Axiym field names and codes.
- [SourceOfFunds](/payment-api/api-reference/0.1.0/schemas/SourceOfFunds.md): Origin of the sender's funds used for this payment. Use BUSINESS_INCOME for general business income not covered by a more specific category. INVESTMENT_INCOME covers investment returns such as interest and dividends; proceeds from selling investments use SALE_OF_OTHER_ASSETS. CAPITAL_CONTRIBUTION covers equity funding; shareholder and intercompany loans use LOAN_PROCEEDS.
- [RelationshipRole](/payment-api/api-reference/0.1.0/schemas/RelationshipRole.md): Canonical role of an individual in relation to the party.
- [PartyRelationshipInput](/payment-api/api-reference/0.1.0/schemas/PartyRelationshipInput.md): An individual related to the sender or recipient, and the role in which they are related.
- [PartyRelationship](/payment-api/api-reference/0.1.0/schemas/PartyRelationship.md): Related individual details stored in the prepared payment instruction.
- [SenderInput](/payment-api/api-reference/0.1.0/schemas/SenderInput.md): Sender details using Axiym field names and exact controlled-value codes. Corridor requirements may add evidence or other constraints.
- [Sender](/payment-api/api-reference/0.1.0/schemas/Sender.md): Sender details stored in the prepared payment instruction, using Axiym field names and codes.
- [Recipient](/payment-api/api-reference/0.1.0/schemas/Recipient.md): The party receiving the payment and its destination account, with canonical controlled values. `recipientId` is present when the recipient comes from the address book.
- [PaymentDataMapDefinition](/payment-api/api-reference/0.1.0/schemas/PaymentDataMapDefinition.md): Reusable rules that transform your complete payment JSON into the Axiym payout input. Field paths are relative to the payment object sent to POST /payouts/mapped. The definition stores rules and reviewed labels, not payment records or file content. Definitions are immutable; store changed rules as a new map. Unsupported schema versions are rejected.
- [CreatePaymentDataMapRequest](/payment-api/api-reference/0.1.0/schemas/CreatePaymentDataMapRequest.md): Name, optional description, and mapping definition to store.
- [PaymentDataMapStatus](/payment-api/api-reference/0.1.0/schemas/PaymentDataMapStatus.md): ACTIVE maps can be used to create payouts. ARCHIVED maps are retained for audit and cannot be used for new payouts.
- [PaymentDataMap](/payment-api/api-reference/0.1.0/schemas/PaymentDataMap.md): Payment Data Map stored for your integration. Its definition and content hash remain unchanged when it is archived.
- [PaymentDataMapPage](/payment-api/api-reference/0.1.0/schemas/PaymentDataMapPage.md): Paginated list of stored Payment Data Maps.
- [SupportingDocumentType](/payment-api/api-reference/0.1.0/schemas/SupportingDocumentType.md): Axiym classification of evidence supplied with a payout.
- [TransactionPurpose](/payment-api/api-reference/0.1.0/schemas/TransactionPurpose.md): Reason for the payment. Each code corresponds to one ISO 20022 purpose code (ExternalPurpose1Code). SERVICES_PAYMENT covers every kind of service, including contractor, IT, legal and financial services. OWN_ACCOUNT_TRANSFER is between accounts of the same legal entity; INTERCOMPANY_TRANSFER is between separate companies in a group; TREASURY_MANAGEMENT is a group treasury operation. LOAN_REPAYMENT covers principal; INTEREST_PAYMENT covers interest. INVESTMENT is a financial investment; a property purchase uses REAL_ESTATE_PURCHASE. OTHER covers purposes outside the listed codes. Accepted purposes depend on the selected corridor.
- [SupportingDocumentInput](/payment-api/api-reference/0.1.0/schemas/SupportingDocumentInput.md): A document supporting the payment, such as an invoice or contract. One item is one file; supply the file content as base64.
- [PayoutRequest](/payment-api/api-reference/0.1.0/schemas/PayoutRequest.md): Creates a payout from a funding account, a fixed amount on one side, and complete payment instruction. Exactly one of `sourceAmount` or `destinationAmount` must be supplied. Sender and recipient data use Axiym's field structure.
- [MappedPayoutRequest](/payment-api/api-reference/0.1.0/schemas/MappedPayoutRequest.md): A saved map identifier and one complete payment object in your agreed source structure. The map prepares the strict Axiym payout input, including payment details, parties, documents, and exactly one fixed amount. The prepared result must meet current corridor requirements.
- [PaymentStatus](/payment-api/api-reference/0.1.0/schemas/PaymentStatus.md): - `PENDING_CONFIRMATION` — created with time-limited terms and awaiting confirmation. No funds are reserved.
- [AccountRef](/payment-api/api-reference/0.1.0/schemas/AccountRef.md): Compact account reference. Fetch the account via `GET /accounts/{accountId}` for the current balance and status; deposit instructions serve its payment details.
- [Payment](/payment-api/api-reference/0.1.0/schemas/Payment.md): Common response document for an outgoing payment. Confirmation authorizes this exact document and reserves `sourceAmount`.
- [SupportingDocument](/payment-api/api-reference/0.1.0/schemas/SupportingDocument.md): Metadata of a document accepted with the payment. File content is not returned.
- [CreateSubscriptionRequest](/payment-api/api-reference/0.1.0/schemas/CreateSubscriptionRequest.md)
- [Subscription](/payment-api/api-reference/0.1.0/schemas/Subscription.md)
- [RequestStatus](/payment-api/api-reference/0.1.0/schemas/RequestStatus.md)
- [PublicKey](/payment-api/api-reference/0.1.0/schemas/PublicKey.md)
- [Error](/payment-api/api-reference/0.1.0/schemas/Error.md): Error response for requests that do not contain field-level validation failures.
- [ValidationErrorResponse](/payment-api/api-reference/0.1.0/schemas/ValidationErrorResponse.md): Error response for field validation failures and business-rule rejections.
- [ValidationFieldErrors](/payment-api/api-reference/0.1.0/schemas/ValidationFieldErrors.md): Nested validation errors keyed by field name or array index. Leaf values are arrays of `ValidationError` objects.
- [ValidationError](/payment-api/api-reference/0.1.0/schemas/ValidationError.md): One field-level validation error.
- [BankAddress](/payment-api/api-reference/0.1.0/schemas/BankAddress.md): Receiving bank address. Its country identifies the payout's destination country and determines the applicable bank-routing requirements. Supply additional address fields when required by the corridor.
- [DestinationInput](/payment-api/api-reference/0.1.0/schemas/DestinationInput.md): Bank account to which the payout is delivered. Corridor requirements determine any additional routing fields.
- [Destination](/payment-api/api-reference/0.1.0/schemas/Destination.md): Where the funds are delivered, as recorded on the operation at creation time. This is a snapshot: it carries the account or wallet details and, when the destination was taken from the address book, its `destinationId`. It does not carry the address book entry's status or creation date; read the address book entry for its current state.
- [BankDestination](/payment-api/api-reference/0.1.0/schemas/BankDestination.md)
- [WalletDestination](/payment-api/api-reference/0.1.0/schemas/WalletDestination.md)
- [BankInput](/payment-api/api-reference/0.1.0/schemas/BankInput.md): Receiving bank details. The bank address country determines the destination corridor; additional routing fields depend on that corridor's requirements.
- [Bank](/payment-api/api-reference/0.1.0/schemas/Bank.md): Receiving bank details returned with the payout, including the applicable clearing system.
- [Network](/payment-api/api-reference/0.1.0/schemas/Network.md): Blockchain network of a wallet address.
- [RecipientInput](/payment-api/api-reference/0.1.0/schemas/RecipientInput.md): Recipient details using Axiym field names and exact controlled-value codes. Corridor requirements may add identification, evidence, or routing requirements.
- [PartyIdentificationTypeValueMap](/payment-api/api-reference/0.1.0/schemas/PartyIdentificationTypeValueMap.md): Exact partner labels mapped to PartyIdentificationType codes. Case and whitespace are significant. Many labels may map to the same code; only values used by your integration need entries. Existing Axiym codes pass unchanged and cannot be mapped to a different code.
- [RelationshipRoleValueMap](/payment-api/api-reference/0.1.0/schemas/RelationshipRoleValueMap.md): Exact partner labels mapped to RelationshipRole codes. Case and whitespace are significant. Many labels may map to the same code; only values used by your integration need entries. Existing Axiym codes pass unchanged and cannot be mapped to a different code.
- [SupportingDocumentTypeValueMap](/payment-api/api-reference/0.1.0/schemas/SupportingDocumentTypeValueMap.md): Exact partner labels mapped to SupportingDocumentType codes. Case and whitespace are significant. Many labels may map to the same code; only values used by your integration need entries. Existing Axiym codes pass unchanged and cannot be mapped to a different code.
- [SourceOfFundsValueMap](/payment-api/api-reference/0.1.0/schemas/SourceOfFundsValueMap.md): Exact partner labels mapped to SourceOfFunds codes. Case and whitespace are significant. Many labels may map to the same code; only values used by your integration need entries. Existing Axiym codes pass unchanged and cannot be mapped to a different code.
- [TransactionPurposeValueMap](/payment-api/api-reference/0.1.0/schemas/TransactionPurposeValueMap.md): Exact partner labels mapped to TransactionPurpose codes. Case and whitespace are significant. Many labels may map to the same code; only values used by your integration need entries. Existing Axiym codes pass unchanged and cannot be mapped to a different code.
- [BusinessRelationshipValueMap](/payment-api/api-reference/0.1.0/schemas/BusinessRelationshipValueMap.md): Exact partner labels mapped to BusinessRelationship codes. Case and whitespace are significant. Many labels may map to the same code; only values used by your integration need entries. Existing Axiym codes pass unchanged and cannot be mapped to a different code.
- [PaymentMapSourcePath](/payment-api/api-reference/0.1.0/schemas/PaymentMapSourcePath.md): Field path relative to the payment object in a mapped payout request. Use dots for nesting and [] for each array level, for example client.people[].fullName. The payment request wrapper is not part of the path. Keys contain letters, digits, or underscores; prototype-related keys are not allowed.
- [PaymentMapRelativeField](/payment-api/api-reference/0.1.0/schemas/PaymentMapRelativeField.md): Field path within one file record. Dots represent nested objects. Array traversal is not supported within a file field.
- [PaymentMapFieldTarget](/payment-api/api-reference/0.1.0/schemas/PaymentMapFieldTarget.md): Leaf in the Axiym payout input. amount.amount and amount.currency are intermediate fields resolved to sourceAmount or destinationAmount by amountResolution. Document fields are configured through documents.
- [PaymentMapField](/payment-api/api-reference/0.1.0/schemas/PaymentMapField.md): Copies one source field to an Axiym field without type coercion. Include every field you intend to send, even if its name already matches Axiym. Unmapped input fields are ignored. Source and target paths must be unique across field rules. Array depth and order must match; fields belonging to the same target array must use the same source array.
- [PaymentMapDocumentTarget](/payment-api/api-reference/0.1.0/schemas/PaymentMapDocumentTarget.md): Axiym document collection that receives the files. Requirements for that collection and its owner follow the payout input schema and selected corridor.
- [PaymentMapDocumentFields](/payment-api/api-reference/0.1.0/schemas/PaymentMapDocumentFields.md): Fields within each source file containing its classification, filename, and complete base64 content. URLs and file identifiers do not replace content. A non-canonical document classification requires a value rule for this destination.
- [PaymentMapDocumentMatch](/payment-api/api-reference/0.1.0/schemas/PaymentMapDocumentMatch.md): An exact ID equality linking a file to its destination record. All matches must hold. IDs must be non-empty strings or finite numbers; strings and numbers are not coerced. For identification evidence, include a match to the identification as well as the owner. Record paths within an array must follow the owner array established by the field rules.
- [PaymentMapDocumentFilter](/payment-api/api-reference/0.1.0/schemas/PaymentMapDocumentFilter.md): Includes a file only when this field equals the saved string, including case and whitespace. All filters must match. Use stable tags to distinguish uses, such as party evidence and payment evidence.
- [NestedPaymentMapDocument](/payment-api/api-reference/0.1.0/schemas/NestedPaymentMapDocument.md): Files are already nested with the payment, party, person, or identification they support. Ownership follows the source structure and established field mappings. No ID matches are needed. Separate owners or identifications cannot be inferred from file names or types.
- [LinkedPaymentMapDocument](/payment-api/api-reference/0.1.0/schemas/LinkedPaymentMapDocument.md): Files are supplied in a separate collection. Match their IDs to the relevant records and optionally filter by usage tags. Each file in a configured source collection must resolve to exactly one destination across all connections; unmatched or ambiguous files cause payout creation to fail. Files retain source order within their destination collection.
- [PaymentMapDocument](/payment-api/api-reference/0.1.0/schemas/PaymentMapDocument.md): Saved connection from one file collection to its Axiym destination. Ownership is determined by nesting or explicit ID matches. The same rules apply to every file on each payout.
- [SourceOfFundsPaymentMapValue](/payment-api/api-reference/0.1.0/schemas/SourceOfFundsPaymentMapValue.md): Reviewed exact translations for a SourceOfFunds field. The source and target must correspond to an existing field rule or document-type connection. A shared source, such as files[].kind, can have different translations for different document destinations.
- [PartyIdentificationTypePaymentMapValue](/payment-api/api-reference/0.1.0/schemas/PartyIdentificationTypePaymentMapValue.md): Reviewed exact translations for a PartyIdentificationType field. The source and target must correspond to an existing field rule or document-type connection. A shared source, such as files[].kind, can have different translations for different document destinations.
- [RelationshipRolePaymentMapValue](/payment-api/api-reference/0.1.0/schemas/RelationshipRolePaymentMapValue.md): Reviewed exact translations for a RelationshipRole field. The source and target must correspond to an existing field rule or document-type connection. A shared source, such as files[].kind, can have different translations for different document destinations.
- [SupportingDocumentTypePaymentMapValue](/payment-api/api-reference/0.1.0/schemas/SupportingDocumentTypePaymentMapValue.md): Reviewed exact translations for a SupportingDocumentType field. The source and target must correspond to an existing field rule or document-type connection. A shared source, such as files[].kind, can have different translations for different document destinations.
- [TransactionPurposePaymentMapValue](/payment-api/api-reference/0.1.0/schemas/TransactionPurposePaymentMapValue.md): Reviewed exact translations for a TransactionPurpose field. The source and target must correspond to an existing field rule or document-type connection. A shared source, such as files[].kind, can have different translations for different document destinations.
- [BusinessRelationshipPaymentMapValue](/payment-api/api-reference/0.1.0/schemas/BusinessRelationshipPaymentMapValue.md): Reviewed exact translations for a BusinessRelationship field. The source and target must correspond to an existing field rule or document-type connection. A shared source, such as files[].kind, can have different translations for different document destinations.
- [PaymentMapValue](/payment-api/api-reference/0.1.0/schemas/PaymentMapValue.md): A dictionary of exact labels for one controlled destination. Rules are unique by source and target. Translations apply after field and document mapping, independently to each array entry. Exact Axiym codes pass unchanged and cannot be redefined. Unknown labels, including differences in case or whitespace, are rejected. Missing optional data is omitted; there are no default values.
- [CurrencyPaymentMapAmount](/payment-api/api-reference/0.1.0/schemas/CurrencyPaymentMapAmount.md): Compares the mapped amount currency with the funding account currency and recipient destination currency on each payout. A funding-currency match fixes sourceAmount; a recipient-only match fixes destinationAmount. If both match, sourceAmount is fixed. Invalid or unavailable required currency information, or a match to neither side, rejects the payout. The funding currency comes from Axiym account data, not the submitted payment.
- [FixedPaymentMapAmount](/payment-api/api-reference/0.1.0/schemas/FixedPaymentMapAmount.md): Always treats the mapped amount as the selected side. Its currency must match that side: the Axiym funding account for sourceAmount, or the mapped recipient destination for destinationAmount. A mismatch rejects the payout.
- [PaymentMapAmountResolution](/payment-api/api-reference/0.1.0/schemas/PaymentMapAmountResolution.md): How the intermediate amount.amount and amount.currency fields become exactly one of sourceAmount or destinationAmount in the prepared payout.