Submit Payment

Updated 10 September 2026

POST `?action=submit_payment`

Records a payment against a work order. Only valid for orders in pending_payment status. Moves the order to payment_submitted regardless of whether the payment is full or partial — admin reviews all payments and resets to pending_payment if a balance remains.

Authentication

Two auth modes are accepted — provide one:

Field	Type	Required	Description
`confirmation_token`	string	Optional*	Token returned by create_work_order
`reference_code`	string	Optional*	Work order reference code
`customer_email`	string	Optional*	Required when using reference_code auth

Request Parameters

Field	Type	Required	Description
`payment_transaction_id`	string	Optional	Your transaction or order ID
`customer_note`	string	Optional	Note from the customer
`amount`	float	Optional	Amount being paid. When omitted, the order is moved to payment_submitted with no amount recorded. When provided, the amount is added to any previous payments and a payment history entry is created.

Response Fields

Field	Type	Description
`work_order_id`	integer	Work order ID
`reference_code`	string	Work order reference code
`status`	string	Always payment_submitted
`fully_paid`	boolean	Whether total received meets or exceeds the order total
`amount_paid`	float	Cumulative total paid — only present when amount was provided
`balance_due`	float	Remaining balance — only present when amount was provided

Example request

$payload = [
    'confirmation_token'     => 'abc123def456...',
    'payment_transaction_id' => 'wc_order_abc123',
    'amount'                 => 9.99,
];
$ch = curl_init('PANELR_API_URL?action=submit_payment');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => json_encode($payload),
    CURLOPT_HTTPHEADER     => [
        'X-Panelr-API-Key: YOUR_API_KEY',
        'Content-Type: application/json',
    ],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

curl -X POST "PANELR_API_URL?action=submit_payment" \
  -H "X-Panelr-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "confirmation_token": "abc123def456...",
    "payment_transaction_id": "wc_order_abc123",
    "amount": 9.99
  }'

const res = await fetch('PANELR_API_URL?action=submit_payment', {
  method: 'POST',
  headers: {
    'X-Panelr-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    confirmation_token: 'abc123def456...',
    payment_transaction_id: 'wc_order_abc123',
    amount: 9.99,
  }),
});
const { data } = await res.json();

import requests
r = requests.post('PANELR_API_URL',
    params={'action': 'submit_payment'},
    headers={'X-Panelr-API-Key': 'YOUR_API_KEY'},
    json={
        'confirmation_token': 'abc123def456...',
        'payment_transaction_id': 'wc_order_abc123',
        'amount': 9.99,
    })
data = r.json()['data']

POST ?action=submit_payment

Authentication

Request Parameters

Response Fields

POST `?action=submit_payment`