mib-payment-verify/README.md

### Maldives Islamic Bank Payment Verification API


This api will allow you to fetch customers payment and your MIB account history, it will match with transaction time, account owner name and amount. \
but slight issue is that, MIB to MIB transaction sometimes have MIBs made-up name for the account owner name, This is challenging, so work around that, I added option to send customers account number to fetch the made-up name and match with it. \
(BML) Farava transations works perfectly with just the name!

## How to deploy/get started (with docker/podman)

1. Login to MIB web (https://faisanet.mib.com.mv/)[https://faisanet.mib.com.mv/] and get the cookie:
![get_cookie_env.png](get_cookie_env.png)
copy this and paste it in .env
```
QL_0=
IBSID=
```
2. Create `compose.yml` with the follwing contents:
```yaml
services:
  keepalive:
    env_file: .env
    image: git.shihaam.dev/shihaam/mib-payment-verify/keepalive
  api:
    env_file: .env
    image: git.shihaam.dev/shihaam/mib-payment-verify/api
    ports:
      - 5000:5000

```
3. Run `docker compose up -d` and that is all.


## Here are example curl commands to test different scenarios:


1. With both benefName and accountNo:
```bash
curl -X POST http://localhost:5000/verify-payment \
     -H "Content-Type: application/json" \
     -d '{
           "benefName": "ABDLA.MAJUDHU AHMED",
           "accountNo": "90103101178641000",
           "absAmount": "100",
           "time": "2024-10-16 16:08"
         }'
```
In this request, it will first try to verify with benfName, if it fails, then it will try with accountNo.

2. With only benefName:
```bash
curl -X POST http://localhost:5000/verify-payment \
     -H "Content-Type: application/json" \
     -d '{
           "benefName": "ABDLA.MAJUDHU AHMED",
           "absAmount": "100",
           "time": "2024-10-16 16:08"
         }'
```
3. With only accountNo:
```bash
curl -X POST http://localhost:5000/verify-payment \
     -H "Content-Type: application/json" \
     -d '{
           "accountNo": "90103101178641000",
           "absAmount": "100",
           "time": "2024-10-16 16:08"
         }'
```


Exmaple Succcess responses;
1. Both benefName and accountNo or only benefName provided
```json
{
  "message": "Payment verified using beneficiary name",
  "success": true
}
```
2. Both benefName and accountNo or only accountNo provided, but failed with benefName
```json
{
  "message": "Payment verified using account number",
  "success": true
}
```
Example Failed response:
1.
```json
{
  "message": "Transaction not found, contact support",
  "success": false
}
```