MoneyHash Transactions API

openapi: 3.2.0
info:
  title: MoneyHash Transactions API
  version: 1.1.0
  description: MoneyHash Public APIs documentation
servers:
- url: https://web.moneyhash.io
tags:
- name: Transactions
paths:
  /api/v1.4/transactions/{trx_uuid}/transition/:
    post:
      operationId: v1.1_transactions_transition_create
      description: Transition only CASH_ON_DELIVERY transactions to successful state
      summary: Transition cash on delivery
      parameters:
      - in: path
        name: trx_uuid
        schema:
          type: string
        description: Transaction unique identifier that you want to transition
        required: true
      tags:
      - Transactions
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateCODTransactionStatus'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/UpdateCODTransactionStatus'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/UpdateCODTransactionStatus'
        required: true
      security:
      - ApiKeyAuth: []
      - AccessTokenAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transaction'
          description: ''
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DocsErrorResponse400'
          description: ''
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DocsErrorResponse401'
          description: ''
components:
  schemas:
    DocsErrorResponse400:
      type: object
      properties:
        status:
          $ref: '#/components/schemas/DocsStatus'
        data:
          type: object
          additionalProperties: {}
        count:
          type:
          - integer
          - 'null'
          description: Total number of items.
        next:
          type:
          - string
          - 'null'
          description: Next page url if exists
        previous:
          type:
          - string
          - 'null'
          description: Previous page url if exists
      required:
      - count
      - data
      - next
      - previous
      - status
    DocsErrorResponse401:
      type: object
      properties:
        status:
          $ref: '#/components/schemas/DocsStatus'
        data:
          type: object
          additionalProperties: {}
        count:
          type:
          - integer
          - 'null'
          description: Total number of items.
        next:
          type:
          - string
          - 'null'
          description: Next page url if exists
        previous:
          type:
          - string
          - 'null'
          description: Previous page url if exists
      required:
      - count
      - data
      - next
      - previous
      - status
    Transaction:
      type: object
      properties:
        id:
          type: string
          description: Transaction ID
        custom_fields: {}
        status:
          type: string
          maxLength: 50
        amount:
          oneOf:
          - type: number
            format: double
          - type: object
            additionalProperties: {}
          readOnly: true
          description: Transaction amount
        amount_currency:
          type: string
          readOnly: true
          description: Transaction currency
        payment_method:
          type: string
          readOnly: true
        payment_method_name:
          type: string
          readOnly: true
        service_provider:
          type:
          - string
          - 'null'
          readOnly: true
        account:
          type: string
          readOnly: true
        billing_data:
          allOf:
          - $ref: '#/components/schemas/BillingDataSerializerField'
          description: Billing data associated with the transaction
        is_retry:
          type: boolean
          readOnly: true
          description: Is this transaction a retry after failure
        authentication_data:
          description: 3ds authentication data
        authentication:
          description: 3ds authentication data
        full_capture:
          type: boolean
          readOnly: true
        created:
          type: string
          format: date-time
          readOnly: true
        modified:
          type: string
          format: date-time
          readOnly: true
      required:
      - account
      - amount
      - amount_currency
      - billing_data
      - created
      - full_capture
      - id
      - is_retry
      - modified
      - payment_method
      - payment_method_name
      - service_provider
    DocsStatus:
      type: object
      properties:
        data:
          description: Response message
      required:
      - data
    BillingDataSerializerField:
      type: object
      properties:
        name:
          type:
          - string
          - 'null'
          description: The full name of the customer. Maximum length is 100 characters.
          maxLength: 100
        first_name:
          type:
          - string
          - 'null'
          description: The first name of the customer. Maximum length is 100 characters.
          maxLength: 100
        last_name:
          type:
          - string
          - 'null'
          description: The last name of the customer. Maximum length is 150 characters.
          maxLength: 150
        email:
          type:
          - string
          - 'null'
          description: The email address of the customer.
        phone_number:
          type:
          - string
          - 'null'
          description: The phone number of the customer. It should be in a valid international format.
        address:
          type: string
          description: The full address of the customer. Maximum length is 500 characters.
          maxLength: 500
        address1:
          type: string
          description: Additional address line for the customer. Maximum length is 500 characters.
          maxLength: 500
        apartment:
          type: string
          description: The apartment number of the customer. Maximum length is 10 characters.
          maxLength: 10
        floor:
          type: string
          description: The floor number of the customer's address. Maximum length is 10 characters.
          maxLength: 10
        building:
          type: string
          description: The building number or name of the customer's address. Maximum length is 255 characters.
          maxLength: 255
        street:
          type: string
          description: The street name of the customer. Maximum length is 500 characters.
          maxLength: 500
        city:
          type: string
          description: The city of the customer. Maximum length is 255 characters.
          maxLength: 255
        state:
          type:
          - string
          - 'null'
          description: The state or province of the customer. Maximum length is 255 characters.
          maxLength: 255
        country:
          type: string
          description: The country of the customer. Maximum length is 255 characters.
          maxLength: 255
        postal_code:
          type: string
          description: The postal code of the customer. Maximum length is 10 characters.
          maxLength: 10
        mobile_wallet_number:
          type:
          - string
          - 'null'
          description: The mobile wallet number of the customer.
    UpdateCODTransactionStatus:
      type: object
      properties:
        target_status:
          enum:
          - successful
          - failed
          type: string
          x-spec-enum-id: 6bc0497ed09b314c
          description: 'Mark the transaction as successful or failed.


            * `successful` - successful

            * `failed` - failed'
        increase_amount:
          type: string
          format: decimal
          pattern: ^-?\d{0,12}(?:\.\d{0,2})?$
          description: Increase the transaction amount.
        decrease_amount:
          type: string
          format: decimal
          pattern: ^-?\d{0,12}(?:\.\d{0,2})?$
          description: Decrease the transaction amount.
      required:
      - target_status
  securitySchemes:
    AccessTokenAuth:
      type: apiKey
      in: query
      name: access_token
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
x-provenance:
  method: searched
  source: https://docs.moneyhash.io/reference
  harvested: '2026-10-26'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://docs.moneyhash.io/reference/v11_accounts_create.md
  - https://docs.moneyhash.io/reference/v11_accounts_get_from_access_token_retrieve.md
  - https://docs.moneyhash.io/reference/v11_accounts_list.md
  - https://docs.moneyhash.io/reference/v11_accounts_payment_methods_create.md
  - https://docs.moneyhash.io/reference/v11_accounts_reset_access_token_create.md
  - https://docs.moneyhash.io/reference/v11_accounts_transactions_list.md
  - https://docs.moneyhash.io/reference/v11_customers_cards_destroy.md
  - https://docs.moneyhash.io/reference/v11_customers_cards_list.md
  - https://docs.moneyhash.io/reference/v11_customers_create.md
  - https://docs.moneyhash.io/reference/v11_customers_destroy.md
  - https://docs.moneyhash.io/reference/v11_customers_list.md
  - https://docs.moneyhash.io/reference/v11_customers_partial_update.md
  - https://docs.moneyhash.io/reference/v11_customers_retrieve.md
  - https://docs.moneyhash.io/reference/v11_customers_subscriptions_retrieve.md
  - https://docs.moneyhash.io/reference/v11_customers_transactions_list.md
  - https://docs.moneyhash.io/reference/v11_customers_wallets_debit_create.md
  - https://docs.moneyhash.io/reference/v11_customers_wallets_top_up_create.md
  - https://docs.moneyhash.io/reference/v11_direct_payments_intent_create.md
  - https://docs.moneyhash.io/reference/v11_direct_payments_intents_card_token_create.md
  - https://docs.moneyhash.io/reference/v11_direct_payments_intents_create.md
  - https://docs.moneyhash.io/reference/v11_direct_payments_intents_receipt_create.md
  - https://docs.moneyhash.io/reference/v11_direct_payments_intents_retrieve.md
  - https://docs.moneyhash.io/reference/v11_direct_payments_intents_update_method_create.md
  - https://docs.moneyhash.io/reference/v11_external_payments_intent_create.md
  - https://docs.moneyhash.io/reference/v11_external_payments_intents_card_token_create.md
  - https://docs.moneyhash.io/reference/v11_external_payments_intents_receipt_create.md
  - https://docs.moneyhash.io/reference/v11_external_payments_intents_retrieve.md
  - https://docs.moneyhash.io/reference/v11_external_payments_intents_update_method_create.md
  - https://docs.moneyhash.io/reference/v11_loyalty_earn_create.md
  - https://docs.moneyhash.io/reference/v11_loyalty_earn_retrieve.md
  - https://docs.moneyhash.io/reference/v11_loyalty_earn_reverse_create.md
  - https://docs.moneyhash.io/reference/v11_loyalty_eligibility_create.md
  - https://docs.moneyhash.io/reference/v11_payment_links_create.md
  - https://docs.moneyhash.io/reference/v11_payment_links_status_retrieve.md
  - https://docs.moneyhash.io/reference/v11_payment_links_update_quantities_create.md
  - https://docs.moneyhash.io/reference/v11_payments_charge_card_token_create.md
  - https://docs.moneyhash.io/reference/v11_payments_intent_close_create.md
  - https://docs.moneyhash.io/reference/v11_payments_intent_create.md
  - https://docs.moneyhash.io/reference/v11_payments_intent_retrieve.md
  - https://docs.moneyhash.io/reference/v11_payments_intents_transactions_list.md
  - https://docs.moneyhash.io/reference/v11_payments_transactions_anomalies_resolve_create.md
  - https://docs.moneyhash.io/reference/v11_payments_transactions_capture_create.md
  - https://docs.moneyhash.io/reference/v11_payments_transactions_increase_authorization_create.md
  - https://docs.moneyhash.io/reference/v11_payments_transactions_pull_status_create.md
  - https://docs.moneyhash.io/reference/v11_payments_transactions_refund_create.md
  - https://docs.moneyhash.io/reference/v11_payments_transactions_retrieve.md
  - https://docs.moneyhash.io/reference/v11_payments_transactions_void_create.md
  - https://docs.moneyhash.io/reference/v11_payout_bulk_requests_cancel_create.md
  - https://docs.moneyhash.io/reference/v11_payout_bulk_requests_create.md
  - https://docs.moneyhash.io/reference/v11_payout_bulk_requests_items_cancel_create.md
  - https://docs.moneyhash.io/reference/v11_payout_bulk_requests_items_list.md
  - https://docs.moneyhash.io/reference/v11_payout_bulk_requests_items_retrieve.md
  - https://docs.moneyhash.io/reference/v11_payout_bulk_requests_list.md
  - https://docs.moneyhash.io/reference/v11_payout_bulk_requests_retrieve.md
  - https://docs.moneyhash.io/reference/v11_payout_intent_close_create.md
  - https://docs.moneyhash.io/reference/v11_payout_intent_create.md
  - https://docs.moneyhash.io/reference/v11_payout_transactions_pull_status_create.md
  - https://docs.moneyhash.io/reference/v11_payout_transactions_void_create.md
  - https://docs.moneyhash.io/reference/v11_subscriptions_card_token_create.md
  - https://docs.moneyhash.io/reference/v11_subscriptions_create.md
  - https://docs.moneyhash.io/reference/v11_subscriptions_list.md
  - https://docs.moneyhash.io/reference/v11_subscriptions_plan_groups_list.md
  - https://docs.moneyhash.io/reference/v11_subscriptions_plan_groups_retrieve.md
  - https://docs.moneyhash.io/reference/v11_subscriptions_plans_create.md
  - https://docs.moneyhash.io/reference/v11_subscriptions_plans_list.md
  - https://docs.moneyhash.io/reference/v11_subscriptions_retrieve.md
  - https://docs.moneyhash.io/reference/v11_subscriptions_retry_payment_create.md
  - https://docs.moneyhash.io/reference/v11_subscriptions_update_amount_create.md
  - https://docs.moneyhash.io/reference/v11_subscriptions_update_discount_create.md
  - https://docs.moneyhash.io/reference/v11_subscriptions_update_plan_create.md
  - https://docs.moneyhash.io/reference/v11_subscriptions_update_remaining_recurring_cycles_create.md
  - https://docs.moneyhash.io/reference/v11_tokens_cards_create.md
  - https://docs.moneyhash.io/reference/v11_tokens_cards_retrieve.md
  - https://docs.moneyhash.io/reference/v11_tokens_intent_details_retrieve.md
  - https://docs.moneyhash.io/reference/v11_transactions_transition_create.md
  - https://docs.moneyhash.io/reference/v12_external_payments_intents_get_current_state_create.md
  - https://docs.moneyhash.io/reference/v14_reconciliations_settlement_files_confirm_upload_create.md
  - https://docs.moneyhash.io/reference/v14_reconciliations_settlement_files_create.md
  - https://docs.moneyhash.io/reference/v14_reconciliations_settlement_operations_list.md
  - https://docs.moneyhash.io/reference/v1_providers_available_list.md
  - https://docs.moneyhash.io/reference/v1_providers_connected_list.md
  - https://docs.moneyhash.io/reference/v1_providers_countries_retrieve.md
  - https://docs.moneyhash.io/reference/v1_providers_sync_available_create.md
  - https://docs.moneyhash.io/reference/v1_providers_sync_available_list.md
  - https://docs.moneyhash.io/reference/v1_providers_sync_connected_list.md
  merge:
    pages: 85
    deduped: 568
    conflicts_kept_first: 0