Custom Payment Methods

Custom Payment Methods let you accept payments through your own manual or external process while still tracking the order inside SellApp. They are useful when your preferred local wallet, bank transfer, private processor, or manual crypto flow is not available as a native integration.

Use them for any payment process where SellApp should create a pending order for you to verify before digital product delivery is completed.

---

Create a custom processor

Open Payment settings, then open Custom Processors and click Add method.

Choose one of two processor flows:

1. Instruction-based: SellApp shows payment instructions on checkout.
2. Redirect-based: SellApp sends the customer to your own payment page.

Then add the payment method name, optional description, optional icon, and the details for that flow.

---

Instruction-based methods

Use instruction-based methods when the customer should read payment details on the SellApp checkout page.

You can add:

1. A short description.
2. Rich instructions.
3. Up to three checkout steps.
4. Proof of payment upload.
5. A customer preview before saving.

If proof is required, the customer can submit text or a screenshot. The order will stay pending until you review it.

---

Redirect-based methods

Use redirect-based methods when you already have a hosted payment page.

Add a short description, then add a redirect URL and include variables when your external flow needs order context. SellApp supports variables like:

1. {id}
2. {invoice_id}
3. {customer_email}
4. {currency}
5. {price}
6. {price_usd}
7. {product_name}
8. {quantity}
9. {return_url}
10. {charge_id} (charges and wallet top-ups only; empty for product orders)

For example, your redirect URL might include the order ID and price so your external page can prefill the checkout. Use {return_url} when your external payment page should send the customer back to the signed SellApp checkout page. For charges, {id}, {invoice_id}, and {charge_id} contain the charge ID, {quantity} is 1, and {product_name} uses its description, reference, or charge label. A return to that URL does not prove that payment was received.

---

Enable on products

When saving a custom processor, you can enable it on all current products. You can also control custom payment methods per variant from the product editor.

Custom processor orders require manual review. Open the order, confirm payment, then mark it completed when the payment is valid. Keep the instructions clear so customers know exactly where to pay, what proof to upload, and when they should expect their order to be reviewed.

Discounts, charges, and wallet top-ups

Each custom method has its own optional percentage and fixed discount or fee. Edit that method in Custom Processors; changing it does not change another method. Positive values discount and negative values add a fee. The percentage is applied first, then the fixed amount once per order or ordinary charge. Fixed amounts use the checkout currency's major units: 1.50 means $1.50 in USD.

Standalone charges can offer enabled custom methods without product assignments. A charge saves the available choices when created; newly added methods are not automatically included. Initialized checkout instructions survive later edits or deletion of the method.

Customers can also choose a custom method for wallet top-ups when enabled in wallet settings. These top-ups charge the exact USD deposit, without custom method discounts or fees. Customer confirmation or proof moves the charge to REVIEW; it adds no wallet balance. Verify the funds before approving the charge. Approval credits the deposit and any saved wallet bonus once. Voiding a custom top-up prevents later approval; it does not refund money received through your external payment process.