Change an advertiser payment
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.
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
advertiserId integer required
Advertiser ID
1001 paymentId integer required
Payment ID, as returned by the payment list
80 Form Params
amount number
New amount, in the network's currency; greater than 0 and at most 9999999.999999
1500.00 comment string
New memo, up to 200 characters; an empty value clears it
September invoice #2231 date string
New payment date, yyyy-MM-dd between 2010 and 2050
2026-09-15 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