Discounts and Taxes #

Getting Started #

Sometime you need to apply discounts and taxes to transactions. Kasir is built with this in mind. You can easily apply discounts and taxes to transactions by following these guides.

Discounts #

To add a discount, call thediscount() method and pass the parameters, This method will also automatically calculate the gross_amount.

The available parameters for discount are:

• amount: int required The amount of the discount, in fixed amount or percentage of the gross_amount (discount rate).
• percentage: bool Determines if the amount is in percentage.
• name: string The name of the discount. This will be displayed in the Midtrans Merchant Account Portal.
• id: string The ID of the discount. This will be displayed in the Midtrans Merchant Account Portal.

Adding a Discount #

$kasir = Kasir::make()
    ->itemDetails($items)
    ->discount(10, true, 'Voucher GoPay', 'voucher-gopay'); 

Adding Multiple Discounts #

To add multiple discounts, chain the discount() method:

$kasir = Kasir::make()
    ->itemDetails($items)
    ->discount(10, true, 'Voucher GoPay', 'voucher-gopay') 
    ->discount(2, true, 'Promo Pengguna Baru', 'new-user');

You can also add multiple discounts by using discounts() method and passing an array of discounts with each discount parameters as the keys.

$kasir = Kasir::make()
    ->itemDetails($items)
    ->discounts([ 
        [
            'id' => 'voucher-gopay',
            'name' => 'Voucher GoPay',
            'amount' => 10,
            'percentage' => true,
        ], [
            'id' => 'new-user',
            'name' => 'Promo Pengguna Baru',
            'amount' => 2,
            'percentage' => true,
        ]
    ]);

or pass an anonymous function:

$kasir = Kasir::make()
    ->itemDetails($items)
    ->discounts(function() { 
        return [
            [
                'id' => 'voucher-gopay',
                'name' => 'Voucher GoPay',
                'amount' => 10,
                'percentage' => true,
            ], [
                'id' => 'new-user',
                'name' => 'Promo Pengguna Baru',
                'amount' => 2,
                'percentage' => true,
            ]
        ];
    });

Taxes #

To add a tax, call thetax() method and pass the parameters, This method will also automatically calculate the gross_amount.

The available parameters for tax are:

• amount: int required The amount of the tax, in fixed amount or percentage of the gross_amount (tax rate).
• percentage: bool Determines if the amount is in percentage.
• name: string The name of the tax. This will be displayed in the Midtrans Merchant Account Portal.
• id: string The ID of the tax. This will be displayed in the Midtrans Merchant Account Portal.

Adding a Tax #

$kasir = Kasir::make()
    ->itemDetails($items)
    ->tax(2, true, 'Biaya Layanan', 'service-fee'); 

Adding Multiple Taxes #

To add multiple taxes, chain the tax() method:

$kasir = Kasir::make()
    ->itemDetails($items)
    ->tax(2, true, 'Biaya Layanan', 'service-fee') 
    ->tax(11, true, 'PPN 11%', 'ppn');

You can also add multiple taxes by using taxes() method and passing an array of taxes with each tax parameters as the keys.

$kasir = Kasir::make()
    ->itemDetails($items)
    ->taxes([ 
        [
            'id' => 'service-fee',
            'name' => 'Biaya Layanan',
            'amount' => 10,
            'percentage' => true,
        ], [
            'id' => 'ppn',
            'name' => 'PPN 11%',
            'amount' => 11,
            'percentage' => true,
        ]
    ]);

or pass an anonymous function:

$kasir = Kasir::make()
    ->itemDetails($items)
    ->taxes(function() { 
        return [
            [
                'id' => 'service-fee',
                'name' => 'Biaya Layanan',
                'amount' => 10,
                'percentage' => true,
            ], [
                'id' => 'ppn',
                'name' => 'PPN 11%',
                'amount' => 11,
                'percentage' => true,
            ]
        ];
    });

Discount and Tax Priority #

Because discounts are generally offered directly by the retailer and reduce the amount of the sales price and the cash received by the retailer, the sales tax applies to the price after the discount is applied. For example, if you have a 11% tax and a 10% discount, the discount will be applied first, then the tax will be applied.

By that rule, these code will produce the same result:

$kasir = Kasir::make()
    ->itemDetails($items)
    ->discount(10, true, 'Voucher GoPay', 'voucher-gopay') 
    ->discount(2, true, 'Promo Pengguna Baru', 'new-user')
    ->tax(2, true, 'Biaya Layanan', 'service-fee')
    ->tax(11, true, 'PPN 11%', 'ppn');

$kasir = Kasir::make()
    ->itemDetails($items)
    ->tax(2, true, 'Biaya Layanan', 'service-fee') 
    ->tax(11, true, 'PPN 11%', 'ppn')
    ->discount(10, true, 'Voucher GoPay', 'voucher-gopay')
    ->discount(2, true, 'Promo Pengguna Baru', 'new-user');

$kasir = Kasir::make()
    ->itemDetails($items)
    ->tax(2, true, 'Biaya Layanan', 'service-fee') 
    ->discount(10, true, 'Voucher GoPay', 'voucher-gopay')
    ->tax(11, true, 'PPN 11%', 'ppn')
    ->discount(2, true, 'Promo Pengguna Baru', 'new-user');