This method allows Interswitch Bill Payment Platforms to validate third party customer information before a payment is made.
Note
- Interswitch Bill Payment platforms would communicate to third party platforms via HTTP Post.
- The data sent via HTTP Post will be xml, hence the content type is text/xml.
- The request message will not be in a parameter but a raw post directly to stream.
- In cases where you choose to implement Customer Validation and Payment Notification (see section 2.1), you are expected to provide Interswitch with a single url that accepts both message.
- Ensure CamelCase naming convention is used for the field returned in the xml
- See Appendix 9.0 for the process flow of Customer Validation
CustomerInformationRequest Fields
This defines the expected xml tags that will be sent to third party systems for Customer Validation. This is a generic system and new tags can be added at any time, do not hard code the structure of the xml requests. Your system should be able to retrieve data from the required fields and ignore others.
Sample Customer Validation Request
This shows the sample request message that would be sent to third-party systems to validate a unique customer identified with the CustReference. The PaymentItemCode is the specific item the customer wants to pay for. Note that additional tags can be added at any time, ensure your system does not break due to this.
Customer Validation Request |
Customer Validation Response without Payment Item |
---|---|
|
|
CustomerInformationResponse Fields
This defines the expected xml tags that should be returned by third party systems during Customer Validation. Interswitch Bill Payment platforms use the status to determine if it is a valid customer or not.
Sample Customer Validation Response
This shows the sample response message that would be returned from third party systems to Interswitch Bill Payment Platforms.
Customer Validation ResponseNB: Amount is returned as 0. meaning customers will be allowed to pay any amount. |
Customer Validation Response with Payment ItemNB: Use response when returned amount is greater than 0. |
---|---|
|
|