1. Docs
  2. Billing

Billing Service Billing Service

Invoice in Awanio is paid by deducting user's Credit. Credit amount is added in 2 ways:

  • Top Up
  • Redeem Voucher Code

We provide customizable way to top up credit amount or invoice payment by using your existing payment gateway (PG) partner.

Payment Gateway

You can add your own payment gateway (PG) partner credential, using API POST /payment/payment-gateway. It has the following parameters:

  • name: PG name ,
  • merchant_code: merchant code defined by your PG,
  • url: URL to get payment page,
  • merchant_key: merchant key defined by your PG,
  • callback: URL to be called by PG to update payment status and reference number,
  • meta: JSON, contains of
    • "return": page to display after payment is successful,
    • "expiryPeriod": the payment will be expired after this period
  • output_type: webview

Learn the API here

Payment Method

Payment methods available can be defined directly from database. It has following properties:

  • uuid: unique ID of payment method
  • name: code for each payment method
  • payment_gateway: name of PG
  • description: it will be display in the list of payment method when user will make a peyment for top up or invoice
  • country: the PG country
  • service_fee: additional fee (if any), default value is 0
  • minimum_amount: now it is set 50000 (in IDR)
  • created_at: the date the record is created
  • updated_at: the date the record is last updated
  • deleted_at: the date the record is deleted. Leave it null when creating/inserting

Top Up

Awanio uses a payment/topup (API) for credit top up from a customer with properties of voucher_uuid, payment_method_id and amount, minimum is IDR 50,000. In the process, we do inquiry to PG to get payment page URL and order ID.

After the payment is made by the user, PG will give callback to Awanio to update the payment status and provide a reference number.

Topup Diagram

Redeem Voucher Code

Voucher in Awanio provide extra credit for customers. They have great flexibility in how you define and use them.

  • Voucher redemptions can be limited or unlimited
  • Limit the usage by a certain length of time or by it's active status
  • You can define vouchers reusable by the same user, or just once

Manage Vouchers

You can perform these actions on the Vouchers page:

  • View all of vouchers
  • Search vouchers by name
  • Create new vouchers
  • View & Update vouchers
  • Delete vouchers

Create a voucher

Vouchers can be created in the Management Console (Dashboard), by clicking Create button from the Vouchers page.

Vouchers have the following parameters:

  • uuid: a unique identifier for the voucher
  • code: the code to be redeemed by customers
  • value: 100000
  • expired_date: the latest date at which this voucher can be applied to customers
  • reusable_same_user: false or true. It lets a single customer using it multiple times if it is set to true.
  • status: active or inactive
  • threshold: maximum redemptions. If a coupon has a threshold value of 50, it can only be applied among all your customers a total of 50 times. You can set 0 for unlimited redemptions.

Edit a voucher

To edit a voucher, complete these steps:

  1. Find the voucher you want to modify on the Vouchers page, click on the action button, then choose Edit.
  2. Make your changes to the data (change the limit, expired date, etc except the voucher code, it is disabled).
  3. Click Update button to save.

Delete a voucher

To delete a voucher, complete these steps:

  1. Find the voucher you want to delete on the Vouchers page.
  2. Click the action button on the right of voucher’s name, then choose Remove.
  3. Confirm your action.

Invoice Payment

If the credit amount is not sufficient for invoice payment, then user must make payment via Billing Page.

The invoice payment process is similar to top up, but the amount will be automatically filled with the amount that must be paid. Minimum payment is IDR 50,000. If the nominal payment on the invoice is less than IDR 50,000, the rest will go to Credit.

We use payment/invoice (API) for invoice payment, by sending invoice_uuid and payment_method_id.