# IndusInd WhatsApp Collect - Approach Document

## Get bill API

### Request

{
    "loan_account_number": "10935351"
    "mobile":"9099909900"
}

### Response

#### Success

{
    "status": "SUCCESS",
    "customerName": "Ashok Kumar",
    "amountDue": "1290.20",
    "dueDate": "21-12-2020"
    additionalInfo:[{'name': 'value'}]
}

__Note:__
* customerName and amountDue are required fields
* "additionalInfo" can be sent to show details about the bill. Maximum of 4.

#### Failure - Customer not found

{
    "status": "FAILURE",
    "error": "customer-not-found"
}

## Payment API

### Request

{
    "loan_account_number": "10935351",
    "amountPaid": "900",
    "transactionId": "AX09812J812",
    "paymentMode": "UPI"
}

#### Success

{
    "status": "SUCCESS",
    "acknowledgementId": "1AJI1344"
}

#### Failure - Can not process payment

{
    "status": "FAILURE",
    "error": "cannot-process-payment"
}

### Minimum Security considerations

1. The API should work from only whitelisted IPs (on production)
2. HTTPS is mandatory
3. Authentication mechanism is required. Ex. API key