> For the complete documentation index, see [llms.txt](https://developer.tokeninc.com/token-developer-portal-1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.tokeninc.com/token-developer-portal-1/payment-service/payment-solutions/tip-integration.md).

# Tip Integration

## 1. Sale

```java
Intent IntentCard = new Intent();
		IntentCard.setPackage(tag);
		IntentCard.setAction(getResources().getString(R.string.Sale_Action)); //Sale_Action="Sale_Action"
        Bundle bundle_card = new Bundle();
	      bundle_card.putInt("Amount",amount);
        bundle_card.putInt("CardReadType",cardReadType);
        bundle_card.putString("CardData",cardData); 
        bundle_card.putString("UUID",uuid); 
	      bundle_card.putInt("allowedCardType",allowedCardType);
	      bundle_card.putInt("isGIBTerminal",isGIBTerminal);
	      bundle.putBoolean("isDovizPOS", isDovizPOS)
	      bundle.putInt("currenyRate", currencyRate)
	      bundle.putInt("currenyUnit", currencyUnit)
        bundle.putString("currencyCode", currencyCode)
        bundle.putInt("currenyAmount", currencyAmount)
        bundle.putLong("tipAmount")
        IntentCard.setType("text/plain");
        IntentCard.putExtras(bundle_card);
        startActivityForResult(IntentCard, getResources().getInteger(R.integer.Sale_Request_Code)); //Sale_Request_Code=1
```

**NOTE:** The `amount` field includes the tip amount and is transmitted as a single value. Additionally, the tip amount is transmitted in the `tipAmount` field.

**NOTE:** In transactions where a tip entry is provided, if the selected bank does not support tip processing, the **amount** field will still include the tip amount and be sent to the bank as the total of **base amount + tip amount**. However, the VAT (KDV) rate applied on the receipt will be calculated and displayed based on the product’s predefined VAT rate, with the tip amount treated as part of the product amount rather than a separate component.

#### **1.1 Sale Response** 

```java
   void onSaleResponseRetrieved(Integer price, ResponseCode code, Boolean hasSlip, SlipType slipType, String cardNo, String ownerName) {
        Intent resultIntent = new Intent();
        Bundle bundle = new Bundle();
        bundle.putInt("ResponseCode", code.ordinal());
        bundle.putInt("PaymentStatus",0);
        bundle.putInt("Amount",price);
        bundle.putInt("Amount2", price);        
        bundle.putInt("BatchNo",0);
        bundle.putInt("TxnNo",0);
        bundle.putInt("InstallmentCount", installmentCount);
        bundle.putBoolean("IsSlip", hasSlip);
        bundle.putInt("SlipType", slipType.value);
        bundle.putString("RefundInfo", refund_info); 
        bundle.putString("CardNo", cardNo);
        bundle.putString("TID", terminal_id);
        bundle.putString("MID", merchant_id);	    
        bundle.putString("RefNo", ref_no);
        bundle.putString("AuthNo", auth_no);
        bundle.putLong("tipAmount",tipAmount);
   
       
        if (slipType == SlipType.CARDHOLDER_SLIP || slipType == SlipType.BOTH_SLIPS) {
            bundle.putString("customerSlipData", PrintHelper.getFormattedText(getSampleReceipt(cardNo, ownerName), SlipType.CARDHOLDER_SLIP));
        }
        if (slipType == SlipType.MERCHANT_SLIP || slipType == SlipType.BOTH_SLIPS) {
            bundle.putString("merchantSlipData", PrintHelper.getFormattedText(getSampleReceipt(cardNo, ownerName), SlipType.MERCHANT_SLIP));
        }
        resultIntent.putExtras(bundle);
        setResult(Activity.RESULT_OK,resultIntent);
        finish();
    }
```

**NOTE:** The `amount` value shall include both the transaction amount and the tip amount. Additionally, the tip amount shall be transmitted separately via the `tipAmount` field.

### **2 Parameter** 

Add **TipAllowed** into **Allowed Operations** as Parameter Action Response Data if Tip Allowed supported. 

**Allowed Operations**

Allowed Operations will be added with the **"AllowedOperations"** tag. The allowed transaction types will be provided as a JSON object. It will indicate whether tip entry is allowed on the terminal. "**TipAllowed**" will be set to “1” if tip entry is supported, and “0” if it is not supported.

Allowed Operations Bundle Example

```java
AllowedOperations={"TipAllowed":1,"QrAllowed":1,"KeyInAllowed":0, "DovizPOSAllowed":1, "CarPayAllowed":1}
```