---
title: "Change an advertiser payment"
type: reference
method: POST
path: /rest-api/advertiser/{advertiserId}/payments/{paymentId}.do
tag: "Network Finances"
---

# Change an advertiser payment

`POST https://YOUR-NETWORK-DOMAIN/rest-api/advertiser/{advertiserId}/payments/{paymentId}.do`

Changes the amount, date or comment of a payment of the advertiser, as Edit on Network Finances → Advertisers Funds and on the advertiser's Funds card does; a field left out keeps its value. The balance moves with the payment: the old amount is taken out from the old month on and the new amount added from the new month on, in one transaction. The payment stays with this advertiser — to move money to another one, delete it and add a new payment there. The change is stamped with the caller and the time (updatedBy, updatedAt) and written to the action log. Requires the NETWORK_BILLING_MANAGEMENT and ADVERTISERS_FUNDS permissions; without campaign VIEW at ALL level the advertiser must be shared with the caller.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `advertiserId` | integer | yes | `1001` | Advertiser ID |
| `paymentId` | integer | yes | `80` | Payment ID, as returned by the payment list |

## Form params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `amount` | number | no | `1500.00` | New amount, in the network's currency; greater than 0 and at most 9999999.999999 |
| `comment` | string | no | `September invoice #2231` | New memo, up to 200 characters; an empty value clears it |
| `date` | string | no | `2026-09-15` | New payment date, yyyy-MM-dd between 2010 and 2050 |

## Responses

- `200` — Payment changed: {success, advertiserId, payment:{paymentId, date, year, month, amount, comment, createdAt, createdBy, updatedAt, updatedBy}}
- `400` — Field errors under 'errors' (amount, date, comment); a date before the month the balances start from (GET /rest-api/network/management/balances-start.do) is refused under 'date'
- `401` — Authentication error
- `403` — The caller lacks one of the required permissions
- `404` — No such advertiser or payment, the payment belongs to another advertiser, or the advertiser is not shared with the caller

## Example request

```bash
curl --request POST \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/advertiser/1001/payments/80.do' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'amount=1500.00' \
  --data-urlencode 'comment=September invoice #2231' \
  --data-urlencode 'date=2026-09-15'
```

Source: https://epom.com/ad-server/docs/api/network-finances/post-advertiser-payments-by-advertiser-id