Update Plan Meter

PATCH

subscriptions

plans

{plan_id}

meters

{meter_id}

Update Plan Meter

curl --request PATCH \
  --url https://api-sandbox.y.uno/v1/subscriptions/plans/{plan_id}/meters/{meter_id} \
  --header 'Content-Type: application/json' \
  --header 'X-Account-Code: <x-account-code>' \
  --header 'X-Idempotency-Key: <x-idempotency-key>' \
  --header 'private-secret-key: <api-key>' \
  --header 'public-api-key: <api-key>' \
  --data '
{
  "credits": 250,
  "price_per_credit": {
    "currency": "USD",
    "value": 0.04
  }
}
'

import requests

url = "https://api-sandbox.y.uno/v1/subscriptions/plans/{plan_id}/meters/{meter_id}"

payload = {
    "credits": 250,
    "price_per_credit": {
        "currency": "USD",
        "value": 0.04
    }
}
headers = {
    "X-Account-Code": "<x-account-code>",
    "X-Idempotency-Key": "<x-idempotency-key>",
    "public-api-key": "<api-key>",
    "private-secret-key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PATCH',
  headers: {
    'X-Account-Code': '<x-account-code>',
    'X-Idempotency-Key': '<x-idempotency-key>',
    'public-api-key': '<api-key>',
    'private-secret-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({credits: 250, price_per_credit: {currency: 'USD', value: 0.04}})
};

fetch('https://api-sandbox.y.uno/v1/subscriptions/plans/{plan_id}/meters/{meter_id}', 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-sandbox.y.uno/v1/subscriptions/plans/{plan_id}/meters/{meter_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'credits' => 250,
    'price_per_credit' => [
        'currency' => 'USD',
        'value' => 0.04
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Account-Code: <x-account-code>",
    "X-Idempotency-Key: <x-idempotency-key>",
    "private-secret-key: <api-key>",
    "public-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api-sandbox.y.uno/v1/subscriptions/plans/{plan_id}/meters/{meter_id}"

	payload := strings.NewReader("{\n  \"credits\": 250,\n  \"price_per_credit\": {\n    \"currency\": \"USD\",\n    \"value\": 0.04\n  }\n}")

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

	req.Header.Add("X-Account-Code", "<x-account-code>")
	req.Header.Add("X-Idempotency-Key", "<x-idempotency-key>")
	req.Header.Add("public-api-key", "<api-key>")
	req.Header.Add("private-secret-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))

}

HttpResponse<String> response = Unirest.patch("https://api-sandbox.y.uno/v1/subscriptions/plans/{plan_id}/meters/{meter_id}")
  .header("X-Account-Code", "<x-account-code>")
  .header("X-Idempotency-Key", "<x-idempotency-key>")
  .header("public-api-key", "<api-key>")
  .header("private-secret-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"credits\": 250,\n  \"price_per_credit\": {\n    \"currency\": \"USD\",\n    \"value\": 0.04\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-sandbox.y.uno/v1/subscriptions/plans/{plan_id}/meters/{meter_id}")

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

request = Net::HTTP::Patch.new(url)
request["X-Account-Code"] = '<x-account-code>'
request["X-Idempotency-Key"] = '<x-idempotency-key>'
request["public-api-key"] = '<api-key>'
request["private-secret-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"credits\": 250,\n  \"price_per_credit\": {\n    \"currency\": \"USD\",\n    \"value\": 0.04\n  }\n}"

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

{
  "id": "77777777-7777-7777-7777-777777777777",
  "plan_id": "00000000-0000-4000-8000-000000000001",
  "meter_id": "66666666-6666-6666-6666-666666666666",
  "credits": 250,
  "pricing_strategy": "PER_UNIT",
  "price_per_credit": {
    "currency": "USD",
    "value": 0.04
  },
  "country_prices": [
    {
      "country": "US",
      "amount": {
        "currency": "USD",
        "value": 0.06
      }
    }
  ],
  "created_at": "2026-08-18T09:00:04.000000Z",
  "updated_at": "2026-08-18T12:15:00.000000Z"
}

Enabled per organizationUsage-based billing must be enabled for your organization before these endpoints accept requests. Contact your Yuno account manager to enable it. Requests from an organization where it is not enabled return 403 PRODUCT_NOT_ENABLED.

Send at least one of credits, pricing_strategy, price_per_credit, country_prices. The same currency rules as Attach Meter to Plan apply. If the meter has been archived (INACTIVE) the metered price is frozen and this call returns 400 PLAN_METER_NOT_FOUND until the meter is reactivated.

PACKAGE/TIERED config is attach-time onlypackage_size, package_price, package_country_prices and tiers cannot be sent to this endpoint — any request containing one of them is rejected with 400 PLAN_METER_PRICING_CONFIG_UNSUPPORTED, regardless of the metered price’s current pricing_strategy. Switching pricing_strategy itself is validated against the metered price’s existing config for the target strategy; an unsupported switch is rejected rather than silently applied. To change a PACKAGE/TIERED config, attach a new meter instead — see the Usage-Based Billing guide.

There is no detach endpoint. To stop billing a meter, archive it with Update Meter (status: INACTIVE), or set credits high enough that no overage is billed.

Refer to Meter Error Codes for the possible error outcomes.

Authorizations

public-api-key

string

header

default:<Your public-api-key>

required

private-secret-key

string

header

default:<Your private-secret-key>

required

Headers

X-Account-Code

string

required

The account_id found in your Yuno Dashboard (UUID). Required — omitting it returns 400 BAD_REQUEST ("Invalid x-account-code header.").

X-Idempotency-Key

string

required

Unique identifier used in HTTP headers to ensure that a request is processed only once, even if it is retried due to network issues or timeouts. Optional, as on the rest of the Yuno API.

Path Parameters

plan_id

string

required

The unique identifier of the plan.

meter_id

string

required

The unique identifier of the meter attached to the plan.

Body

application/json

credits

number<float>

Units included in the plan per billing cycle — the allowance a subscriber can consume before any usage is billed. Must be >= 0. 0 means every unit is billed.

pricing_strategy

enum<string>

How usage beyond credits is priced: PER_UNIT (billable units × price_per_credit), PACKAGE (bundles of N units, partial bundle counts as a full one) or TIERED (graduated tiers, each band at its own rate).

Available options:

PER_UNIT,

PACKAGE,

TIERED

price_per_credit

object

Show child attributes

country_prices

object[]

Optional explicit per-country price per unit. One entry per country — a repeated country is rejected with 400 INVALID_PARAMETERS. A country not listed falls back to price_per_credit.

Show child attributes

Response

200

string

The unique identifier of the metered price (the plan-meter relation).

plan_id

string

meter_id

string

credits

number

Units included in the plan per billing cycle.

pricing_strategy

enum<string>

Available options:

PER_UNIT,

PACKAGE,

TIERED

price_per_credit

object | null

null when inherited from the meter's default_price (USD plans).

Show child attributes

country_prices

object[]

Show child attributes

created_at

string

Set by Yuno on creation.

updated_at

string

Set by Yuno on every update.

⌘I

Update Plan Meter

curl --request PATCH \
  --url https://api-sandbox.y.uno/v1/subscriptions/plans/{plan_id}/meters/{meter_id} \
  --header 'Content-Type: application/json' \
  --header 'X-Account-Code: <x-account-code>' \
  --header 'X-Idempotency-Key: <x-idempotency-key>' \
  --header 'private-secret-key: <api-key>' \
  --header 'public-api-key: <api-key>' \
  --data '
{
  "credits": 250,
  "price_per_credit": {
    "currency": "USD",
    "value": 0.04
  }
}
'

import requests

url = "https://api-sandbox.y.uno/v1/subscriptions/plans/{plan_id}/meters/{meter_id}"

payload = {
    "credits": 250,
    "price_per_credit": {
        "currency": "USD",
        "value": 0.04
    }
}
headers = {
    "X-Account-Code": "<x-account-code>",
    "X-Idempotency-Key": "<x-idempotency-key>",
    "public-api-key": "<api-key>",
    "private-secret-key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PATCH',
  headers: {
    'X-Account-Code': '<x-account-code>',
    'X-Idempotency-Key': '<x-idempotency-key>',
    'public-api-key': '<api-key>',
    'private-secret-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({credits: 250, price_per_credit: {currency: 'USD', value: 0.04}})
};

fetch('https://api-sandbox.y.uno/v1/subscriptions/plans/{plan_id}/meters/{meter_id}', 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-sandbox.y.uno/v1/subscriptions/plans/{plan_id}/meters/{meter_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'credits' => 250,
    'price_per_credit' => [
        'currency' => 'USD',
        'value' => 0.04
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Account-Code: <x-account-code>",
    "X-Idempotency-Key: <x-idempotency-key>",
    "private-secret-key: <api-key>",
    "public-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api-sandbox.y.uno/v1/subscriptions/plans/{plan_id}/meters/{meter_id}"

	payload := strings.NewReader("{\n  \"credits\": 250,\n  \"price_per_credit\": {\n    \"currency\": \"USD\",\n    \"value\": 0.04\n  }\n}")

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

	req.Header.Add("X-Account-Code", "<x-account-code>")
	req.Header.Add("X-Idempotency-Key", "<x-idempotency-key>")
	req.Header.Add("public-api-key", "<api-key>")
	req.Header.Add("private-secret-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))

}

HttpResponse<String> response = Unirest.patch("https://api-sandbox.y.uno/v1/subscriptions/plans/{plan_id}/meters/{meter_id}")
  .header("X-Account-Code", "<x-account-code>")
  .header("X-Idempotency-Key", "<x-idempotency-key>")
  .header("public-api-key", "<api-key>")
  .header("private-secret-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"credits\": 250,\n  \"price_per_credit\": {\n    \"currency\": \"USD\",\n    \"value\": 0.04\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-sandbox.y.uno/v1/subscriptions/plans/{plan_id}/meters/{meter_id}")

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

request = Net::HTTP::Patch.new(url)
request["X-Account-Code"] = '<x-account-code>'
request["X-Idempotency-Key"] = '<x-idempotency-key>'
request["public-api-key"] = '<api-key>'
request["private-secret-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"credits\": 250,\n  \"price_per_credit\": {\n    \"currency\": \"USD\",\n    \"value\": 0.04\n  }\n}"

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

{
  "id": "77777777-7777-7777-7777-777777777777",
  "plan_id": "00000000-0000-4000-8000-000000000001",
  "meter_id": "66666666-6666-6666-6666-666666666666",
  "credits": 250,
  "pricing_strategy": "PER_UNIT",
  "price_per_credit": {
    "currency": "USD",
    "value": 0.04
  },
  "country_prices": [
    {
      "country": "US",
      "amount": {
        "currency": "USD",
        "value": 0.06
      }
    }
  ],
  "created_at": "2026-08-18T09:00:04.000000Z",
  "updated_at": "2026-08-18T12:15:00.000000Z"
}

Getting Started

Reference

Customers

Network Tokens

Customer Sessions (Enrollment)

Checkout Sessions

Payment Methods (Checkout)

Checkout Builder

Payment Methods (Direct Workflow)

PCI Proxy

Payments

Pre-Debit Notifications

3DS2 Setup

Unreferenced Refunds

Dry-run

Transaction Reporting

Routing Recommendations

Payment Links

Recipients for Marketplace

Sellers (Franchise)

Subscriptions Plans

Subscriptions

Payouts

Organizations

Reports

Installments

AI Caller

Communications Campaigns

Conversion Rate

Banking Connectivity

Webhooks

Authorizations

Headers

Path Parameters

Body

Response