Mock Commerce & Billing

Direct Charges & Refunds API

Execute single-step charges without client-side tokenization, and issue full or partial refunds against settled transactions. Includes automatic ledger recalculations, status transitions (partially_refunded vs refunded), and webhook dispatching.

Partial Refund Calculator API Consoles Code Recipes

Interactive Partial Refund Simulator

Slide to adjust the refund amount and inspect ledger updates and terminal status tags in real time.

Refund Amount Slider$30.00 USD

Refund Reason

Target Intent ID

Ledger State

Original Charged:$80.00

Amount to Refund:-$30.00

Remaining Net:$50.00

Resulting Status:partially_refunded

Interactive API Consoles

Execute direct card transactions and refund requests against your isolated visitor sandbox.

1. Direct 1-Step Card Charge

Process Direct Charge

POST

response.json

{

// Click "Send" above to execute this request against the live server.

}

2. Issue Full or Partial Refund

Issue Refund Against Payment Intent

POST

response.json

{

// Click "Send" above to execute this request against the live server.

}

3. List All Processed Refunds

List Sandbox Refunds

GET

response.json

{

// Click "Send" above to execute this request against the live server.

}

Production Integration Recipes

Safe idempotency patterns and customer service refund workflows.

Idempotent Refund Helper (Node.js)

javascript

import axios from 'axios';

// Safely refund an order with duplicate-click protection

export async function refundOrder(paymentIntentId, amountCents, reason = 'requested_by_customer') {

const idempotencyKey = rf_${paymentIntentId}_${amountCents};

try {

const res = await axios.post(

'https://playground.nileslabs.com/api/v1/payments/refunds',

{

payment_intent: paymentIntentId,

amount: amountCents,

reason,

{

headers: { 'Idempotency-Key': idempotencyKey },

}

);

console.log('Refund successful:', res.data.id, 'Status:', res.data.status);

return res.data;

} catch (err) {

console.error('Refund failed:', err.response?.data?.error?.message);

throw err;

}

Automated Refund Worker (Python)

python

import requests

def issue_partial_refund(intent_id: str, amount_cents: int, reason: str = "requested_by_customer"):

url = "https://playground.nileslabs.com/api/v1/payments/refunds"

headers = {"Idempotency-Key": f"ref_{intent_id}_{amount_cents}"}

payload = {

"payment_intent": intent_id,

"amount": amount_cents,

"reason": reason

}

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

response.raise_for_status()

data = response.json()

print(f"Issued refund {data['id']} for {data['amount']} cents")

return data

PreviousCustomers Vault

NextTest Cards Catalog