Basics
This topic describes the basics of how to use Rebilly and complete transactions in the sandbox environment using a payment card. You do not need developer experience to complete this tutorial.
Use this tutorial to learn the basics of how to use Rebilly.
Step 1: Log in or sign up
Step 2: Select the sandbox environment
In the top right corner of the page, press your initials and then press Sandbox.
Step 3: Optionally, add a payment gateway
- This step is optional. The sandbox environment is pre-configured with a test gateway account. If you do not want to add a payment gateway, skip this step and proceed to Step 4.
- To add a payment gateway, you must have a payment gateway account and a merchant account.
This step describes how to add a payment gateway account to Rebilly and configure it to accept payments made using a payment card. A payment gateway is a service which enables a business to receive payments from customers to their merchant bank account. For more information on gateway accounts, and how to configure them, see Gateway accounts.
- In the left navigation bar, press Settings .
- In the Configuration section, press Gateway accounts.
- Press Add gateway account.
- Select a gateway account.
- In the Gateway account ID field, enter a unique alphanumeric value. Use a value that is recognizable in your reports. This ID is used in other configuration screens, and is how this account is referenced within the API.
- Enter your gateway account credentials.
- In the Payment methods section, in the Select a payment method dropdown, select payment-card.
- Optionally, Configure advanced gateway settings.
- Press Save gateway account.
Step 4: Personalize your organization
This step describes how to personalize your organization in Rebilly by adding your company logo and organization information. For more information, see My organizations and websites.
- In the left navigation bar, press Settings .
- In the Management section, press My organization & websites.
- On the right of the Organization details tile, press Edit.
- Add your company logo, organization name, and other information.
- Press Save organization.
Step 5: Complete a payment
This step describes how to set up and complete a payment.
5.1: Create a customer
This step describes how to add a new customer to Rebilly. For a complete list of customer interactions, and how to complete them, see Customers interactions.
- In the left navigation bar, press Data tables, then press Customers.
- In the right of the page, press Add customer.
- Enter the following customer details:
- ID:
charlie-sullivan
- First name:
Charlie
- Last name:
Sullivan
- Organization:
Sullivan Inc
- Address line 1:
34 South Independence Mall West
- City:
Philadelphia
- Country:
United States
- Region:
Pennsylvania
- Postal/Zip code:
19106
- Email:
charlie.sullivan@gmail.com
- ID:
- In the Default payment instrument section, select None.
- At the bottom the page, press Save customer.
5.2: Collect payment
This step describes how to use a hosted payment form to collect payment from a customer. For a complete list of payments interactions, and how to complete them, see Payments interactions.
- In the left navigation bar, press Data tables, then press Leads.
Note: 'Leads' contains information on customers who have not made a payment yet. 'Customers' contains information on customers who have made a payment. - In the Name column, press Charlie Sullivan.
- In the top right of the page, press , then press Collect payment.
- Enter an amount and add a description for the payment.
- Select the Pay with Rebilly hosted payment form option, then press Submit.
- Press Copy URL.
- Open the URL in a browser.
- In the hosted payment form, enter the card details:
Note: This card does not generate a real charge.- Card number:
4111 1111 1111 1111
. - Expiration date: any future date.
- CVV: any 3 digits.
- Card number:
- Press Continue, then press Confirm.
5.3: View the completed transaction
This step describes how to view the completed payment. For more information, see View payments activity and View payment transaction details.
- In the left navigation bar, press Data tables, then press Customers.
- Press Customers, then in the Name column, press Charlie Sullivan.
- Scroll down to Timeline. A record of the transaction is displayed.
To view payment gateway information for the transaction, press the message with the approved status.
Step 6: Create an invoice and collect payment
This step describes how to create an order and pay the related invoice.
Rebilly enables merchants to manage and automate recurring payments, products and pricing, invoicing, and subscriptions.
6.1: Create a product and pricing plan
In Rebilly, products are the items that your business sells. Pricing plans are how your customers pay for the items.
This step describes one type of product and pricing plan. For more information on product and pricing plan options, see Products and pricing.
- In the left navigation bar, press Settings .
- In the Pricing section, press Product & pricing plans.
- In the right of the page, press Add product.
- In the Name field, enter
test-product
. - Enter your product details.
- Scroll to the bottom of the page, then press Create pricing plan.
- Enter pricing plan details:
- In the Name field, enter
one-time-plan
.
The ID field is automatically populated. - Select a currency.
- Under Type, select One time sale.
- In the Pricing formula dropdown, select Flat rate.
For more information on pricing plans and formulas, see Pricing formulas. - In the Price per unit field, enter
22.00
. - At the bottom of the page, press Create pricing plan.
- In the Name field, enter
6.2: Create an order on a customer's account
This step describes how to add an order to a customer's account. It creates an invoice with an unpaid
status. For more information on the invoice cycle and statuses, see Invoice lifecycle.
An order is a customer's request to purchase items. It can contain subscription and one-time sale items. For a complete list of billing interactions, and how to complete them, see Billing interactions.
- In the left navigation bar, press Data tables, then press Customers.
- Press Customers, then in the Name column, press Charlie Sullivan.
- In the top right of the screen, press , then press Create order.
- In the Order type section, select One time order.
- In the Products and plans section, in the Products dropdown, select test-product.
- Press + Select a plan, then select one-time-plan.
- At the bottom of the page, press Save order.
6.3: Pay the invoice
This step describes how to access an unpaid invoice and collect payment from a customer using a hosted payment form.
- In the left navigation bar, press Data tables.
- Press Billing and then press Unpaid invoices.
- In the Customer column, locate the invoice for Charlie Sullivan. Then, in the Invoice number column, press the number.
- On the invoice, press Pay invoice.
- Select Pay with Rebilly hosted payment form, then press Submit.
- Press Copy URL, then open the URL in a web browser.
- In the Payment card field, enter the following card details:
Note: This card does not generate a real charge.- Card number:
4111 1111 1111 1111
. - Expiration date: any future date.
- CVV: any 3 digits.
- Card number:
- Press Continue, press Pay, then press Confirm.
6.4: View the paid invoice and completed transaction
This step describes how to view a completed billing transaction. For a complete list of billing interactions, and how to complete them, see Billing interactions.
- In the left navigation bar, press Data tables.
- Press Billing and then press Paid invoices.
- Locate the invoice for Charlie Sullivan. Then, in the Invoice number column, press the number.
- Scroll down to Timeline. A record of the transaction is displayed.
To view payment gateway information for the transaction, press the message with the approved status.
7: View KPIs
This step describes how to view Key Performance Indicators (KPIs) on the payments you have completed in this tutorial.
Rebilly provides KPIs on payments, billing, KYC, and API requests. For more information, see KPIs.
- In the left navigation bar, press KPIs , then press Payments.
- Mouse-over or press Sales, then press Go to report.
- In the top left of the screen, press Transactions.
- In the top right of the screen, press the date picker, then select a date range.
To make a quick date range selection, on the right of the date picker, press then make a selection. - A payment transaction chart is displayed. For more information, Payment reports.