---
title: "POST /money/operations"
method: POST
path: "/money/operations"
tags: ["money"]
---

# POST /money/operations

`POST /money/operations`

## Request

- Base URL: `https://api.betteroff.finance`
- URL: `https://api.betteroff.finance/money/operations`
- Auth: HTTP bearer

## Request body

- union
  - object
    - `requestId` string, uuid, required
    - `description` string
    - `action` 'pay', required
    - `walletId` string, required
    - `amountCents` integer, required
    - `counterparty` union, required
      - object
        - `type` 'email', required
        - `value` string, email, required
      - object
        - `type` 'phone', required
        - `value` string, required
      - object
        - `type` 'handle', required
        - `value` string, required
  - object
    - `requestId` string, uuid, required
    - `description` string
    - `action` 'request', required
    - `walletId` string, required
    - `amountCents` integer, required
    - `counterparty` union, required
      - object
        - `type` 'email', required
        - `value` string, email, required
      - object
        - `type` 'phone', required
        - `value` string, required
      - object
        - `type` 'handle', required
        - `value` string, required
  - object
    - `requestId` string, uuid, required
    - `description` string
    - `action` 'deposit', required
    - `walletId` string, required
    - `amountCents` integer, required
    - `externalAccountId` string, required
  - object
    - `requestId` string, uuid, required
    - `description` string
    - `action` 'withdraw', required
    - `walletId` string, required
    - `amountCents` integer, required
    - `externalAccountId` string, required
  - object
    - `requestId` string, uuid, required
    - `description` string
    - `action` 'internal', required
    - `walletId` string, required
    - `amountCents` integer, required
    - `destinationWalletId` string, required
  - object
    - `requestId` string, uuid, required
    - `description` string
    - `action` 'checkout', required
    - `amountCents` integer, required
  - object
    - `requestId` string, uuid, required
    - `description` string
    - `action` 'fulfill', required
    - `walletId` string, required
    - `amountCents` integer, required
    - `resourceId` string, required
  - object
    - `requestId` string, uuid, required
    - `description` string
    - `action` 'pay_bill', required
    - `walletId` string, required
    - `amountCents` integer, required
    - `payeeAccountId` string, required
    - `reference` string
  - object
    - `requestId` string, uuid, required
    - `description` string
    - `action` 'cancel_bill', required
    - `resourceId` string, required
  - object
    - `requestId` string, uuid, required
    - `description` string
    - `action` 'cancel_payment', required
    - `resourceId` string, required
  - object
    - `requestId` string, uuid, required
    - `description` string
    - `action` 'cancel_request', required
    - `resourceId` string, required
  - object
    - `requestId` string, uuid, required
    - `description` string
    - `action` 'cancel_checkout', required
    - `resourceId` string, required
  - object
    - `requestId` string, uuid, required
    - `description` string
    - `action` 'refund', required
    - `resourceId` string, required
    - `amountCents` integer, required
    - `reason` 'duplicate' | 'fraudulent' | 'requestedByPayer', required

## Response `200`

Success

## Other responses

- `default`: Problem details

---

[API](https://skmtc.dev/betteroff/apis/betteroff-api.md) · [All operations](https://skmtc.dev/betteroff/apis/betteroff-api/llms.txt) · [OpenAPI document](https://skmtc.dev/betteroff/apis/betteroff-api/revisions/bc858c8d428d?raw)
