This is the endpoint for handling notification after a successful funding.
Request Message Description
| Field# | Field name | Data type | Required | Max Length | Description | Options |
|---|---|---|---|---|---|---|
| 1 | ServiceUrl | String | yes | |||
| 2 | RouteId | String | yes | |||
| 3 | MerchantReference | String | yes | |||
| 4 | PaymentLogId | String | yes | |||
| 5 | Amount | String | yes | amount | ||
| 6 | CustReference | String | yes | wallet identifier | ||
| 7 | AlternateCustReference | String | yes | card pan | ||
| 8 | PaymentReference | String | yes | |||
| 9 | PaymentMethod | String | yes | |||
| 10 | ChannelName | String | yes | |||
| 11 | PaymentDate | String | yes |
Endpoint
Base URL : https://api-gateway.interswitchng.comRequest: POST/generic-wallet/sec/api/v1/wallets/funding/{clientCode}/{idType}
Header
Content-Type: text/xml
Authorization: {passport generated bearer token}
Sample Request
<?xml version="1.0" encoding="UTF-8"?> <PaymentNotificationRequest> <RouteId>httpgenericvpn3</RouteId> <ServiceUrl>localhost:8099/generic-wallet/sec/api/v1/wallets/funding/IKIA806308E06B849FE8497AF4113AE5D7A8893D869A/phone</ServiceUrl> <ServiceUsername /> <ServicePassword /> <FtpUrl>localhost:8099/generic-wallet/sec/api/v1/wallets/funding/IKIA806308E06B849FE8497AF4113AE5D7A8893D869A/phone</FtpUrl> <FtpUsername /> <FtpPassword /> <Payments> <Payment> <IsRepeated>False</IsRepeated> <ProductGroupCode>ecash</ProductGroupCode> <PaymentLogId>6470782</PaymentLogId> <CustReference>08062993383</CustReference> <AlternateCustReference>5061000103301029327</AlternateCustReference> <Amount>100.00</Amount> <PaymentStatus>0</PaymentStatus> <PaymentMethod>Debit Card</PaymentMethod> <PaymentReference>FBN|Web|3IWP0001|EEA|170919144127|67282921</PaymentReference> <TerminalId /> <ChannelName>WEB</ChannelName> <Location /> <IsReversal>False</IsReversal> <PaymentDate>09/17/2019 14:41:28</PaymentDate> <SettlementDate>09/17/2019 00:00:01</SettlementDate> <InstitutionId>EEA</InstitutionId> <InstitutionName>Generic e-Account</InstitutionName> <BranchName /> <BankName>First Bank of Nigeria Plc</BankName> <FeeName /> <CustomerName>service echange</CustomerName> <OtherCustomerInfo>|2348090667412</OtherCustomerInfo> <ReceiptNo>1962500070</ReceiptNo> <CollectionsAccount>455455354545</CollectionsAccount> <ThirdPartyCode>5061000103301029327</ThirdPartyCode> <PaymentItems> <PaymentItem> <ItemName>EChange e-Account</ItemName> <ItemCode>EEA</ItemCode> <ItemAmount>100.00</ItemAmount> <LeadBankCode>FBN</LeadBankCode> <LeadBankCbnCode>011</LeadBankCbnCode> <LeadBankName>First Bank of Nigeria Plc</LeadBankName> <CategoryCode /> <CategoryName /> <ItemQuantity>1</ItemQuantity> </PaymentItem> </PaymentItems> <BankCode>FBN</BankCode> <CustomerAddress /> <CustomerPhoneNumber>2348113056853</CustomerPhoneNumber> <DepositorName>2348090667412</DepositorName> <DepositSlipNumber>FBN|api|QTELL|17-09-</DepositSlipNumber> <PaymentCurrency>566</PaymentCurrency> <OriginalPaymentLogId /> <OriginalPaymentReference /> <Teller>service generic</Teller> </Payment> </Payments> </PaymentNotificationRequest>
Sample Response (success)
<?xml version="1.0" encoding="UTF-8"?> <PaymentNotificationResponse> <responseCode>0</responseCode> <responseMessage>Successful</responseMessage> <Payments> <Payment> <PaymentLogId>6470782</PaymentLogId> <Status>0</Status> </Payment> </Payments> <SystemResponseCode>0</SystemResponseCode> <SystemResponseMessage>Successful</SystemResponseMessage> </PaymentNotificationResponse>