Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Instant Payment

...

Instant Payment Notifications (IPN)’s will be fired when the merchant has provided a NotificationURL in the SetTransaction or DoTransaction API call under the following conditions:

  1. When a payment on the PayU redirect either fails or is succeeds.

  2. When a user session times out on the PayU redirect with no chance for the user to finish payment.

  3. When a 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 with 1 minute intervals, failing which the IPN data will automatically be sent to the merchant as an email.The Fraud node will only be present if fraud checking is enabled for the merchant.

IPN example

<PaymentNotification Stage="false">

    <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>

...

You can read more about IPN in general here.