Instant Payment Notifications (IPN’s) will be fired in the following cases when the merchant has provided a NotificationURL in their getTransaction or doTransaction API callInstant Payment Notifications (IPNs) are sent back to the NotificationURL in (but not limited to) the following scenarios:
When a payment on the PayU redirect either fails or is successful When a user session times out on the PayU redirect with no chance for the user to finish payment(3D secure redirect)
When transaction pending review for fraud is either approved or rejected by case managers. In the case of approval the IPN will fire after the payment has been attempted and will return that result.
The NotificationURL can be set to an HTTP or HTTPS endpoint. PayU will attempt to post the IPN 3 times and 1 minute interval, failing which the IPN data will automatically be sent in an email to the email of the merchant.
The fraud node will only be present if fraud is enabled for the merchant.
Example
<PaymentNotification> <MerchantReference>MREF026</MerchantReference> <TransactionType>PAYMENT</TransactionType> <TransactionState>SUCCESSFUL</TransactionState> <ResultCode>00</ResultCode> <ResultMessage>Successful</ResultMessage> <PayUReference>80a0c8eb-fa63-40d3-94f0-8bdabc324932</PayUReference> <Basket> <Description>ADS026</Description> <AmountInCents>2100</AmountInCents> <CurrencyCode>ZAR</CurrencyCode> </Basket> <PaymentMethodsUsed> <CreditCard Information="Visa" NameOnCard=”Mr Soap” CardNumber=”522112xxxxxx1234” AmountInCents="10000" /> </PaymentMethodsUsed> <IpnExtraInfo> <ResponseHash>7a06fe382948e97ad9207b8528d8c1f6847ac10d6230118ff9b3fb90eeaa4743</ResponseHash> </IpnExtraInfo> <Fraud> <ResultCode>V032</ResultCode> <ResultMessage>Case manager approved transaction</ResultMessage> <CaseManagerNote>I got hold of the user and verified</CaseManagerNote> </Fraud> </PaymentNotification> |
---|
<PaymentNotification>
<MerchantReference>MREF026</MerchantReference>
<TransactionType>PAYMENT</TransactionType>
<TransactionState>SUCCESSFUL</TransactionState>
<ResultCode>00</ResultCode>
<ResultMessage>Successful</ResultMessage>
<PayUReference>80a0c8eb-fa63-40d3-94f0-8bdabc324932</PayUReference>
<Basket>
<Description>ADS026</Description>
<AmountInCents>2100</AmountInCents>
<CurrencyCode>ZAR</CurrencyCode>
</Basket>
<PaymentMethodsUsed>
<CreditCard Information="Visa" NameOnCard=”Mr Soap” CardNumber=”522112xxxxxx1234” AmountInCents="10000" >
</PaymentMethodsUsed>
<IpnExtraInfo>
<ResponseHash>7a06fe382948e97ad9207b8528d8c1f6847ac10d6230118ff9b3fb90eeaa4743</ResponseHash>
</IpnExtraInfo>
<Fraud>
<ResultCode>V032</ResultCode>
<ResultMessage>Case manager approved transaction</ResultMessage>
<CaseManagerNote>I got hold of the user and verified</CaseManagerNote>
<Fraud>
...
For a detailed overview of the process please go to the Instant Payment Notification section here