---
updatedAt: 2025-11-10T23:57:08.000Z
agentTools:
  projectIndex: https://docs.interswitchgroup.com/llms.txt
---

# Value Financing Transaction Notification

This Service receives a Transaction Notification response from a Value Financing Channel (such as Webpay). Subsequently, it is expected to send a request down to the Provider to notify them of the final status of the transaction. The Provider is in-turn expected to return a response acknowledging receipt of the request.

**RESPONSE CODE**

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th style={{ textAlign: "left" }}>
        Response Code
      </th>

      <th style={{ textAlign: "left" }}>
        Response Message
      </th>

      <th style={{ textAlign: "left" }}>
        Applicable Request
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td style={{ textAlign: "left" }}>
        00
      </td>

      <td style={{ textAlign: "left" }}>
        success
      </td>

      <td style={{ textAlign: "left" }}>
        All
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        3001
      </td>

      <td style={{ textAlign: "left" }}>
        No Offer
      </td>

      <td style={{ textAlign: "left" }}>
        Get Loan Status, Get Offer
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        4001
      </td>

      <td style={{ textAlign: "left" }}>
        Declined offer
      </td>

      <td style={{ textAlign: "left" }}>
        Get Offer, Accept Offer
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        4002
      </td>

      <td style={{ textAlign: "left" }}>
        Offer Expired
      </td>

      <td style={{ textAlign: "left" }}>
        Accept Offer
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        4004
      </td>

      <td style={{ textAlign: "left" }}>
        Unknown Offer
      </td>

      <td style={{ textAlign: "left" }}>
        Get Loan Status, Accept Offer, Payment Notification
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        4005
      </td>

      <td style={{ textAlign: "left" }}>
        Loan failed
      </td>

      <td style={{ textAlign: "left" }}>
        Value Financing Transaction Notification
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        5000
      </td>

      <td style={{ textAlign: "left" }}>
        System Error
      </td>

      <td style={{ textAlign: "left" }}>
        All
      </td>
    </tr>
  </tbody>
</Table>

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "ipg",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://sandbox.interswitchng.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "oauth2",
        "flows": {}
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/{endpoint goes here. The Provider is expected to provide this and configured on the ILS Platform}": {
      "post": {
        "summary": "Value Financing Transaction Notification",
        "description": "This Service receives a Transaction Notification response from a Value Financing Channel (such as Webpay). Subsequently, it is expected to send a request down to the Provider to notify them of the final status of the transaction. The Provider is in-turn expected to return a response acknowledging receipt of the request.",
        "operationId": "value-financing-transaction-notification-1",
        "parameters": [
          {
            "name": "requestCode",
            "in": "query",
            "description": "The request code indicating the status of the loan application",
            "required": true,
            "schema": {
              "type": "string",
              "default": "00"
            }
          },
          {
            "name": "Authorization",
            "in": "header",
            "schema": {
              "type": "string",
              "default": "Bearer eyJhbGciOiJSUzI1NiJ9.eyJhdWQiOlsiY2FyZGxlc3Mtc2VydmljZSIsImluY29nbml0byIsImlzdy1jb2xsZWN0aW9ucyIsImlzdy1jb3JlIiwiaXN3LWxlbmRpbmctc2VydmljZSIsImlzdy1wYXltZW50Z2F0ZXdheSIsInBhc3Nwb3J0IiwicGF5bWVudC1zZXJ2aWNlIiwicHJvamVjdC14LW1lcmNoYW50IiwidmF1bHQiXSwibWVyY2hhbnRfY29kZSI6Ik1YMTg3IiwicHJvZHVjdGlvbl9wYXltZW50X2NvZGUiOiIwMDE2NDYzOTg1NCIsInJlcXVlc3Rvcl9pZCI6IjAwMTE3NjE0OTkyIiwic2NvcGUiOlsicHJvZmlsZSJdLCJqdGkiOiIzNTFjNDQ5MS01YzcwLTRhOTEtODRiZS0zZjNjY2Q1YzE2Y2MiLCJwYXlhYmxlX2lkIjoiMjMyNCIsImNsaWVudF9pZCI6IklLSUE5NjE0QjgyMDY0RDYzMkU5QjY0MThERjM1OEE2QTRBRUE4NEQ3MjE4IiwicGF5bWVudF9jb2RlIjoiMDQyNTk0MTMwMjQ2In0.P2mUITLA2bsmMryCyuVwDXK-4ozcRYtEKIN1t-qRPZaUStKleLsgxQxJqXv0EZ0CIYbAECw28AeJmbiBtosVSQ824unhfYTyhRCAt1olO_pNwf6PPmMNVTUO5q7F1b3CQPKP5D3VmNMw3MrHUzTzLwqMMzTIAYWf3V-7TEuHBOVzTsOtmuV-j63qASkFGsn_3x-TwgPVeOZ-INnDtXnSCSwQKG10q0_QE7B-ke2v0Up0vxXJ4wTsX8qWm6sJ5Bn_GU260qNPnVCip93xhzAHv7e__ONfeTMdDVPypQ0lyKgcR0FcBrJqONz6yifuu2BfoGeDkXV1cyZFhZg_xwiFYw"
            }
          },
          {
            "name": "requestMessage",
            "in": "query",
            "description": "The description of the requestCode.",
            "required": true,
            "schema": {
              "type": "string",
              "default": "Successful"
            }
          },
          {
            "name": "loanId",
            "in": "query",
            "description": "The Id of the accepted loan from the provider",
            "required": true,
            "schema": {
              "type": "string",
              "default": "ILS08492"
            }
          },
          {
            "name": "customerId",
            "in": "query",
            "description": "The Mobile Number of the User who is requesting the loan.",
            "required": true,
            "schema": {
              "type": "string",
              "default": "23408053012121"
            }
          },
          {
            "name": "loanStatus",
            "in": "query",
            "description": "The Status of the Loan whether it is successful or not. Expected values are \"OPEN\" or \"FAILED\"",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                ""
              ],
              "default": "OPEN"
            }
          },
          {
            "name": "amount",
            "in": "query",
            "description": "The loan amount",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64",
              "default": null
            }
          },
          {
            "name": "transactionId",
            "in": "query",
            "description": "Transaction Id generated by lending service to the downstream payment service. To be used for investigating the transaction.",
            "required": true,
            "schema": {
              "type": "string",
              "default": "739374884937283937"
            }
          },
          {
            "name": "transactionReference",
            "in": "query",
            "description": "The Reference to the payment that was done. This can be used by the Provider to do dispute settlement or investigate.",
            "schema": {
              "type": "string",
              "default": "FBN|WEB|ILS|20170503121143|8903"
            }
          },
          {
            "name": "paymentDate",
            "in": "query",
            "description": "The Date/Time at which merchant was paid for the service for which the customer requested the loan.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date",
              "default": "2017-06-12T11:46:15Z"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"responseCode\": 00,\n    \"responseMessage\": \"Successful\"\n}"
                  }
                }
              }
            }
          },
          "500": {
            "description": "500",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"responseCode\": 500,\n    \"responseMessage\": \"Something we wrong\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "responseCode": {
                      "type": "integer",
                      "example": 500,
                      "default": 0
                    },
                    "responseMessage": {
                      "type": "string",
                      "example": "Something we wrong"
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false,
        "security": []
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```