19JXFGfRUV4NedS5tBGfJhkfRrN2EQtxVo
This project contains implementations of PayPal IPN integrations using different languages.
This is a standalone container that you can use to perform PayPal IPN transactions.
You can find it containerized here.
It receives a POST from your application with the information to initiate a PayPal transaction. It submits the transaction to PayPal. Then, it processes the IPN notification from PayPal. If the transaction is validated/successful, it forwards the information to your application for processing.
-
Your application submits the POST to this container. It will show the user a page letting them know that they are being transferred to PayPal to complete the checkout. The container waits the time that you specify. The container then submits the transaction details by redirecting the user.
-
The user cancels the PayPal checkout. PayPal will redirect them back to the container (You must provide the return URL for cancellations, like: https://payments.mystore.com/index.php?action=cancel). They will see a notification that the transaction was cancelled and will be transferred to the Cart page of your application after a wait time that you determine.
-
The user completes the PayPal checkout. PayPal will redirect the user back to the container (You must provide the return URL for cancellations, like: https://payments.mystore.com/index.php?action=complete). They will see a notification that the checkout was completed and will be transferred to the Orders page of your application after a wait time that you determine.
-
PayPal submits an Instant Payment Notification. Upon the completion of the checkout, PayPal will then send an IPN to a hidden endpoint (the user doesn't see it). (You must provide the return URL, like: https://payments.mystore.com/index.php?action=ipn) The container will perform the validation (submitting the information back to PayPal for confirmation) and if the response from PayPal is that the transaction is "VERIFIED", then passes the IPN data to your application on a script that you specify in an ENV variable.
NOTE: You can implement your own Cancel and Complete pages if you want, instead of relying on the container's. Just change the URL that is configured in the container's ENV variables. You do need to POST to the root inside the container (https://payments.mystore.com/index.php) and use the <<action=ipn>> endpoint though (https://payments.mystore.com/index.php?action=ipn). This is assuming that you host this container in https://payments.mystore.com.
| Base | URL Endpoint | Required | Purpose |
|---|---|---|---|
| pay.site.com | /index.php | YES | Initiate the transaction |
| pay.site.com | /index.php?action=cancel | NO | Acknowledge transaction cancellation |
| pay.site.com | /index.php?action=complete | NO | Acknowledge completed checkout |
| pay.site.com | /index.php?action=ipn | YES | Perform IPN validation |
The IPN Simulator will no longer be supported. It should only be used as a reference of what FINAL responses for validations look like, not to test the actual functionality of this implementation.