All guides
Admin

Manual Payments

Configure payment settings or complete a payment-related workflow.

Step-by-step guide

Before you start

Use an administrator account for this feature.

Open this feature

Open /admin/manual-payments on your application domain, or use the matching item in the application menu.

Steps

Confirm payment & renew now / Save changes

  1. Open /admin/manual-payments/create on your own application domain.
  2. Complete these fields in that form: Payment reference, Payment info, Final amount, Plan price, Discount, Currency, Internal notes. Their choices and limits are listed below.
  3. Select Confirm payment & renew now / Save changes. The exact label can change between creating and editing a record.
  4. If validation fails, correct the named field and submit again. After success, reopen the same record and compare the saved values.
Field shown in the formWhat to enterExample / note
Payment referenceRequired. No more than 190 characters.Use the value required by the task; no example is assumed.
Payment infoOptional, unless this form asks for it. No more than 2000 characters.Use the value required by the task; no example is assumed.
Final amountRequired. Enter a number. At least 0.Use the value required by the task; no example is assumed.
Plan priceOptional, unless this form asks for it. Enter a number. At least 0.Use the value required by the task; no example is assumed.
DiscountOptional, unless this form asks for it. Enter a number. At least 0.Use the value required by the task; no example is assumed.
CurrencyRequired. No more than 10 characters.Use the value required by the task; no example is assumed.
Internal notesOptional, unless this form asks for it. No more than 2000 characters.Use the value required by the task; no example is assumed.

Fields shown in the interface

Only fields traced to this role’s handler and its own view are listed. The application can show separate create/edit forms; do not fill every row on one screen.

Form 1 — fields shown in the interface
FieldWhat to enter or choose
Payment referenceRequired. No more than 190 characters.
Payment infoOptional, unless this form asks for it. No more than 2000 characters.
Final amountRequired. Enter a number. At least 0.
Plan priceOptional, unless this form asks for it. Enter a number. At least 0.
DiscountOptional, unless this form asks for it. Enter a number. At least 0.
CurrencyRequired. No more than 10 characters.
Internal notesOptional, unless this form asks for it. No more than 2000 characters.

Check the result

After a source-checked procedure, verify the same record in the same workspace. Check saved values, visible state and access with the intended test account. An external payment/message/provider action needs its own result check.

Problems and validation

ProblemNext step
A field rejects the valueCheck its named error, the form’s visible choices and the relevant limit. Do not substitute internal numeric codes for the displayed options.
The control is missingCheck role, plan, enabled app and current record state. Do not grant administrator access merely to complete a User task.
The saved result is unexpectedReopen the same record and verify its owner/workspace before repeating the action.

Messages defined for this screen

MessageWhat to review
Discount cannot be greater than the plan price.Check the related field or action in this role’s form.
An approved purchase cannot be changed.Check the related field or action in this role’s form.

Technical reference

Role-scoped source references

Pinned commit: 37d44a1727216f5c492205024b323aa522730ebc

Source-only route information
MethodSource-default route
GET/admin/manual-payments
GET/admin/manual-payments/create
GET/admin/manual-payments/{manualPayment}/edit
Unmapped fields — not user instructions

These fields belong to this role’s source handler, but their screen labels were not confirmed.

Source keyHandler
uidmodules/Admin/AdminManualPayments/Livewire/ManualPaymentForm.php
plan_idmodules/Admin/AdminManualPayments/Livewire/ManualPaymentForm.php
statusmodules/Admin/AdminManualPayments/Livewire/ManualPaymentForm.php
statusmodules/Admin/AdminManualPayments/Livewire/ManualPaymentForm.php