Approve reward
curl --request POST \
--url https://api.example.com/v1/rewards/{id}/approveimport requests
url = "https://api.example.com/v1/rewards/{id}/approve"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://api.example.com/v1/rewards/{id}/approve', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/v1/rewards/{id}/approve",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/v1/rewards/{id}/approve"
req, _ := http.NewRequest("POST", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.example.com/v1/rewards/{id}/approve")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/rewards/{id}/approve")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_body{
"data": {
"id": "rwd_01jcx7m4q9v2k8t5r3n6w0ha1b",
"key": "invoice_1001",
"action": "sale",
"status": "ok",
"customer": "customer_123",
"partner": "partner_123",
"amount": 200.0,
"amount_units": "USD",
"is_currency": true,
"credit": false,
"created_at": "2026-11-12T09:30:00.000000Z",
"deleted_at": null,
"product_type_data": [],
"paid": false,
"payout_status": "available",
"transaction": "invoice_1001"
},
"status": 1
}
Rewards
Approve reward
Approve a commission that’s in review so it counts toward the partner’s balance
POST
/
v1
/
rewards
/
{id}
/
approve
Approve reward
curl --request POST \
--url https://api.example.com/v1/rewards/{id}/approveimport requests
url = "https://api.example.com/v1/rewards/{id}/approve"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://api.example.com/v1/rewards/{id}/approve', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/v1/rewards/{id}/approve",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/v1/rewards/{id}/approve"
req, _ := http.NewRequest("POST", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.example.com/v1/rewards/{id}/approve")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/rewards/{id}/approve")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_body{
"data": {
"id": "rwd_01jcx7m4q9v2k8t5r3n6w0ha1b",
"key": "invoice_1001",
"action": "sale",
"status": "ok",
"customer": "customer_123",
"partner": "partner_123",
"amount": 200.0,
"amount_units": "USD",
"is_currency": true,
"credit": false,
"created_at": "2026-11-12T09:30:00.000000Z",
"deleted_at": null,
"product_type_data": [],
"paid": false,
"payout_status": "available",
"transaction": "invoice_1001"
},
"status": 1
}
Endpoint
POST https://api.partnero.com/v1/rewards/{id}/approve
Affiliate programs only. In newsletter and refer-a-friend programs this endpoint returns
428. Call it server-side, since it needs your secret API key.review_period to ok, it’s added to the partner’s balance and can be paid out. If you use postbacks, the commission-approved postback is sent.
Use it with the Until manually approved review period when commissions should only count after your own system confirms the sale. See Approving commissions from your own system.
The call is safe to retry. Approving a reward that’s already approved changes nothing and returns the reward as is.
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The reward’s ID, e.g. rwd_01jcx7m4q9v2k8t5r3n6w0ha1b |
Request
cURL
curl --location --request POST 'https://api.partnero.com/v1/rewards/rwd_01jcx7m4q9v2k8t5r3n6w0ha1b/approve' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY'
Response
Returns the updated reward, in the same format as Get reward.{
"data": {
"id": "rwd_01jcx7m4q9v2k8t5r3n6w0ha1b",
"key": "invoice_1001",
"action": "sale",
"status": "ok",
"customer": "customer_123",
"partner": "partner_123",
"amount": 200.0,
"amount_units": "USD",
"is_currency": true,
"credit": false,
"created_at": "2026-11-12T09:30:00.000000Z",
"deleted_at": null,
"product_type_data": [],
"paid": false,
"payout_status": "available",
"transaction": "invoice_1001"
},
"status": 1
}
Error responses
| Status | Error | Solution |
|---|---|---|
| 401 | Unauthenticated | Check your API key is set in the Authorization header |
| 404 | Reward not found | Check the ID belongs to a reward in this program |
| 422 | Only rewards in review can be approved or declined | The reward isn’t in review, for example it was already declined. Check its status with Get reward |
| 428 | Rewards are not valid for this program type. They are only available for affiliate programs. | Use an API key of an affiliate program |
Was this page helpful?
