Update a payment

const options = {
  method: 'PATCH',
  headers: {
    'Melio-Entity-Id': '<melio-entity-id>',
    'api-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    deliveryPreference: 'rtp',
    noteToRecipient: 'Invoice 42 (updated)',
    metadata: {invoiceId: 'INV-2043'}
  })
};

fetch('https://api.melio.com/v2/payments/{paymentId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.melio.com/v2/payments/{paymentId}"

payload = {
    "deliveryPreference": "rtp",
    "noteToRecipient": "Invoice 42 (updated)",
    "metadata": { "invoiceId": "INV-2043" }
}
headers = {
    "Melio-Entity-Id": "<melio-entity-id>",
    "api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

curl --request PATCH \
  --url https://api.melio.com/v2/payments/{paymentId} \
  --header 'Content-Type: application/json' \
  --header 'Melio-Entity-Id: <melio-entity-id>' \
  --header 'api-key: <api-key>' \
  --data '
{
  "deliveryPreference": "rtp",
  "noteToRecipient": "Invoice 42 (updated)",
  "metadata": {
    "invoiceId": "INV-2043"
  }
}
'

HttpResponse<String> response = Unirest.patch("https://api.melio.com/v2/payments/{paymentId}")
  .header("Melio-Entity-Id", "<melio-entity-id>")
  .header("api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"deliveryPreference\": \"rtp\",\n  \"noteToRecipient\": \"Invoice 42 (updated)\",\n  \"metadata\": {\n    \"invoiceId\": \"INV-2043\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.melio.com/v2/payments/{paymentId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Melio-Entity-Id"] = '<melio-entity-id>'
request["api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"deliveryPreference\": \"rtp\",\n  \"noteToRecipient\": \"Invoice 42 (updated)\",\n  \"metadata\": {\n    \"invoiceId\": \"INV-2043\"\n  }\n}"

response = http.request(request)
puts response.read_body

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.melio.com/v2/payments/{paymentId}"

	payload := strings.NewReader("{\n  \"deliveryPreference\": \"rtp\",\n  \"noteToRecipient\": \"Invoice 42 (updated)\",\n  \"metadata\": {\n    \"invoiceId\": \"INV-2043\"\n  }\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Melio-Entity-Id", "<melio-entity-id>")
	req.Header.Add("api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "id": "pay_9f8c7b6a5d4e3f21",
  "externalId": "invoice-2043",
  "amount": 125000,
  "currency": "USD",
  "originatingAccountId": "acct_3f2504e0-4f89-41d3-9a0c-0305e82c3301",
  "receivingAccountId": "acct_9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "deductionDate": "2026-07-10",
  "deliveryPreference": "rtp",
  "deliveryDate": "2026-07-10",
  "status": "scheduled",
  "noteToRecipient": "Invoice 42 (updated)",
  "metadata": {
    "invoiceId": "INV-2043"
  },
  "fees": [],
  "createdAt": "2026-07-08T15:04:05Z",
  "updatedAt": "2026-07-08T15:12:00Z"
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "VALIDATION_ERROR",
    "message": "<string>",
    "details": {}
  }
}

{
  "error": {
    "type": "authorization_error",
    "code": "BUSINESS_NOT_ELIGIBLE",
    "message": "Business is not eligible to make payments. See the limitations endpoint for details."
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "VALIDATION_ERROR",
    "message": "<string>",
    "details": {}
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "VALIDATION_ERROR",
    "message": "<string>",
    "details": {}
  }
}