Skip to main content
DELETE
/
wallets
/
{id}
Terminate wallet
curl --request DELETE \
  --url https://api-m.paypal.com/v1/commerce/billing/wallets/{id} \
  --header 'Authorization: Bearer <token>'
{
  "external_customer_id": "client-12345",
  "status": "ACTIVE",
  "available_balance": {
    "value": 120.35,
    "currency_code": "USD"
  },
  "ongoing_usage": {
    "value": 100,
    "currency_code": "USD"
  },
  "net_balance": {
    "value": 50,
    "currency_code": "USD"
  },
  "name": "Prepaid Wallet",
  "rate_amount": "1.5",
  "available_credits": "28.0",
  "ongoing_usage_credits": "10.0",
  "net_balance_credits": "18.0",
  "consumed_credits": "2.0",
  "created_at": "2025-01-01T00:00:00Z",
  "expiration_at": "2025-01-01T00:00:00Z",
  "terminated_at": "2025-01-01T00:00:00Z",
  "applies_to": {
    "fee_types": [
      "SUBSCRIPTION"
    ]
  },
  "recurring_transaction_rules": [
    {
      "trigger": "THRESHOLD",
      "paid_credits": "20.0",
      "granted_credits": "10.0",
      "method": "FIXED",
      "interval": "MONTHLY",
      "started_at": "2025-01-01T00:00:00Z",
      "expiration_at": "2025-01-01T00:00:00Z",
      "threshold_credits": "5.0",
      "target_ongoing_balance": "200.0"
    }
  ],
  "id": "sub_01H3YT8P7Q5R3S1T2U0V4W9X8"
}

Authorizations

​
Authorization
string
header
required

Use the /v1/oauth2/token endpoint to obtain an access token and pass it as a Bearer token in the Authorization header.

Path Parameters

​
wallet_id
string
required

Wallet ID

Response

Wallet terminated successfully

​
external_customer_id
string
required

External system reference to the customer

Example:

"client-12345"

​
status
enum<string>
required

Current status of the wallet

Available options:
ACTIVE,
TERMINATED,
PENDING
Example:

"ACTIVE"

​
rate_amount
string
required

Price charged per credit unit

Example:

"1.5"

​
available_balance
object
​
ongoing_usage
object

The ongoing usage of the wallet, and it reflects all current usage and draft invoices including taxes.

Example:
{ "value": 100, "currency_code": "USD" }
​
net_balance
object

This represents the real-time balance after accounting for current usage,.

Example:
{ "value": 50, "currency_code": "USD" }
​
name
string

Human-readable wallet name

Example:

"Prepaid Wallet"

​
available_credits
string

Current credit balance available

Example:

"28.0"

​
ongoing_usage_credits
string

This reflects all current usage and draft invoices.

Example:

"10.0"

​
net_balance_credits
string

This represents the real time balance after accounting for current usage.

Example:

"18.0"

​
consumed_credits
string

Total credits consumed so far

Example:

"2.0"

​
created_at
string<date-time>

Date and time when the wallet was created, represented in ISO 8601 datetime format and expressed in Coordinated Universal Time (UTC). Date and time in ISO 8601 format.

Example:

"2023-10-01T12:00:00Z"

​
expiration_at
string<date-time>

Date and time when the wallet is set to expire, represented in ISO 8601 datetime format and expressed in Coordinated Universal Time (UTC). Date and time in ISO 8601 format.

Example:

"2023-10-01T12:00:00Z"

​
terminated_at
string<date-time>

Date and time when the wallet was terminated, represented in ISO 8601 datetime format and expressed in Coordinated Universal Time (UTC). Date and time in ISO 8601 format.

Example:

"2023-10-01T12:00:00Z"

​
applies_to
object

Indicates whether the prepaid credit applies to the entire invoice or only to specific line items.

​
recurring_transaction_rules
object[]

List of recurring transaction rules for automatic top-ups

​
id
string

Unique identifier for the wallet

Example:

"1a901a90-1a90-1a90-1a90-1a901a901a90"

⌘I