---
title: Add a beneficiary payment to a confirmed transaction.
slug: fx-api/add-a-beneficiary-payment-to-a-confirmed-transaction
docTags: 
createdAt: 2025-05-30T02:39:22.452Z
---

{
  "id": "nYathBkaoFVabxDLH9bFd",
  "type": "api-oas-v2",
  "data": {
    "method": "POST",
    "url": "https://sand-api.monoova.com/global/v1/transactions/{id}/payments",
    "servers": [
      {
        "url": "https://sand-api.monoova.com/global/v1/transactions/{id}/payments",
        "description": "Monoova Global server"
      }
    ],
    "name": "Add a beneficiary payment to a confirmed transaction.",
    "description": "<p>This creates pending payments to beneficiaries for the given transaction. The beneficiary currency must mach the transaction counter currency, and the total amount of beneficiary transactions must not exceed the counter currency amount of the transaction. Payments can then be updated, deleted or all the payments on the transaction can be confirmed once finalised. - One or more payments can be added by submitting separate payment objects. - The total amount of all payments must match the transaction's <code>counter_currency_amount</code>.</p>",
    "contentType": "application/json",
    "request": {
      "pathParameters": [
        {
          "kind": "required",
          "name": "id",
          "type": "integer",
          "description": "Transaction ID"
        }
      ],
      "headerParameters": [
        {
          "name": "accept",
          "type": "string",
          "kind": "optional",
          "description": "Generated from available response content types",
          "enum": [
            "application/json"
          ],
          "default": "application/json"
        }
      ],
      "queryParameters": [],
      "bodyDataParameters": [
        {
          "kind": "required",
          "name": "body",
          "type": "object",
          "description": "",
          "schema": [
            {
              "name": "payment",
              "kind": "optional",
              "type": "object",
              "description": "",
              "modelRef": "#/components/schemas/PaymentRequest",
              "customType": "PaymentRequest",
              "schema": []
            }
          ],
          "isExpanded": true
        }
      ],
      "formDataParameters": [],
      "oAuthParameters": [],
      "cookieParameters": []
    },
    "responses": [
      {
        "statusCode": "200",
        "description": "A payment.",
        "jsonExample": "",
        "isExpanded": true,
        "schema": [
          {
            "kind": "optional",
            "type": "object",
            "description": "",
            "schema": [
              {
                "name": "payment",
                "kind": "optional",
                "type": "object",
                "description": "",
                "modelRef": "#/components/schemas/Payment",
                "customType": "Payment",
                "schema": []
              }
            ],
            "isExpanded": true
          }
        ]
      }
    ],
    "hasXCodeSamples": false,
    "examples": {
      "languages": [
        {
          "id": "pp4HIpuKT6IU3YTYyw2G8",
          "language": "curl",
          "label": "cURL",
          "code": "curl --request POST \\\n     --url https://sand-api.monoova.com/global/v1/transactions/{id}/payments \\\n     --header 'accept: application/json'"
        },
        {
          "id": "szu6x7BJHpBm3891PpZis",
          "language": "javascript",
          "label": "javascript",
          "code": "var myHeaders = new Headers();\nmyHeaders.append(\"accept\", \"application/json\");\nmyHeaders.append(\"content-type\", \"application/json\");\n\nvar requestOptions = {\n   method: 'POST',\n   headers: myHeaders,\n   redirect: 'follow'\n};\n\nfetch(\"https://sand-api.monoova.com/global/v1/transactions/{id}/payments\", requestOptions)\n   .then(response => response.text())\n   .then(result => console.log(result))\n   .catch(error => console.log('error', error));"
        },
        {
          "id": "UQl_qFd5aH6WFO5E9b43m",
          "language": "ruby",
          "label": "Ruby",
          "code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://sand-api.monoova.com/global/v1/transactions/{id}/payments\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Post.new(url)\nrequest[\"accept\"] = \"application/json\"\nrequest[\"content-type\"] = \"application/json\"\n\nresponse = https.request(request)\nputs response.read_body\n"
        },
        {
          "id": "LS0w54-bLbzCTnrvslrhP",
          "language": "python",
          "label": "Python",
          "code": "import requests\nimport json\n\nurl = \"https://sand-api.monoova.com/global/v1/transactions/{id}/payments\"\n\npayload = {}\nheaders = {\n   'accept': 'application/json',\n   'content-type': 'application/json'\n}\n\nresponse = requests.request(\"POST\", url, headers=headers, data=payload)\n\nprint(response.text)\n"
        }
      ],
      "selectedLanguageId": "pp4HIpuKT6IU3YTYyw2G8"
    },
    "results": {
      "languages": [
        {
          "id": "6UzeLiSoMW9M1cerdwdLC",
          "language": "200",
          "code": "// A payment.\n{\n  \"payment\": {}\n}"
        }
      ],
      "selectedLanguageId": "6UzeLiSoMW9M1cerdwdLC"
    }
  },
  "children": [
    {
      "text": ""
    }
  ]
}