Paypal Button Variables: How to Send and Receive Data
I recently worked on a project where we needed to send and receive Paypal button variables.
Basically I needed to send the registration form ID (that was filled out before the payment) to Paypal, so that when the payment was processed and redirected back to my site, I could populate the info from the latest form submission on a different "success" page.
Also, I wanted to display the status, to show a successful transaction, the amount paid, and the transaction ID.
I'll also discuss some ways to send a specific amount to Paypal that you want the client to pay.
So let's look into these Paypal button variables:
Sending and Receiving Paypal Button Variables
Before doing any of this, be sure to set your Return URL, and enable PDT (Payment Data Transfer).
To do so, click on the Gear icon at the top (settings), then go to Website Payments (this may be found under My Selling Tools in older versions of Paypal), and choose Website Preferences. There, turn Auto Return on, and enter the URL for which you want to return to after payment processing. Next, turn Payment Data Transfer to On.
Setting up your payment button
As you probably already know, you can set up a Paypal payment button by going to Tools > All Tools > Paypal Buttons. This will generate some HTML code to place the button on your site. (See the info on hosted vs non-hosted buttons below).
Sending and receiving a custom message
You can no longer send data to Paypal from an input field in an encrypted/hosted button. It doesn't work.
However you can send it through the URL parameter.
The easiest way to do this is to tack it onto the action URL as a parameter, like so:
And of course, we can pass a variable as well. So if my parameter was the form ID (and my language was PHP), I would put:
action="https://www.paypal.com/cgi-bin/webscr?custom=<?= $form_id ?>"
**Now this is important…note the parameter name..custom
Here in the docs, we see the custom variable. It's a "pass-through" variable and you need to use this when sending a URL parameter.
So how do we receive this variable back after processing?
Here in the docs are listed the PDT specific variables. The variable cm is used to get that custom message back and is what will need to be referenced when returned.
So with the above variable example, when it redirects us back to the page, we can $_GET the parameter back by referencing cm like so:
$form_id = $_GET['cm'];
And that will give me my form ID to use in my new page and then I can do what I need to from there.
Receiving transaction details
Receiving the transaction details is easy and if you have enabled the above PDT option, will be sent regardless to your redirect page via the URL parameters. They are found here, and can be used as such to $_GET this data. So to get amount, status, and transaction ID, we can simply put something like:
$status = $_GET['st']; $transactionID = $_GET['tx']; $amount = $_GET['amt'];
And then we can work with those variables.
How to pass a specific payment amount to Paypal
Now here's where things get tricky in regards to Paypal button variables..
When it comes to a Paypal Button, there are two types: a Hosted Paypal Button, and a Non-Hosted Paypal button with the difference being obvious, hosted and not hosted.
When you created a Paypal Button, there is an option on the second dropdown to "Save button at PayPal." Check it to have a hosted button, leave it unchecked for a non-hosted button:
Here's the rule and please let me know if I am wrong:
You cannot pass an amount to Paypal with a hosted button.
So can you with a non-hosted button?
Yes….with a few prehaps controversial tweaks:
So let's say you create a non-hosted button. Its code looks something like this:
See that loooong encrypted input field? Scroll the code over and see.
As long as that is there, you cannot pass a specific amount to PayPal. So if you need to do this, remove that input.
Second, you must change the _s-xclick to _xclick.
Now you can pass an amount like such:
<input type="hidden" name="amount" value="<?= $registration_fee ?>">
There is some talk about having to include the business field to make this work. I didn't test it, but included it anyway, along with the currency type, so if it doesn't work, be sure to try these:
<input type="hidden" name="currency_code" value="USD"> <input type="hidden" name="business" value="A8387GHJF"> <input type="hidden" name="amount" value="<?= $registration_fee ?>">
And yes that is a made up business value, don't be hacking me.
Be sure to put your Merchant ID there (not your email as spammers will pick it up). You can find that in Settings > About the Business
And all works now. You can dynamically or statically feed a value to Paypal. Buuutttt, you're not encrypted. I offer no advice here for you. Do what you must.
That being said, using the API is always safer. So if the budget allows, or you can choose or create a solid plugin to do this, always do that as it's much safer.
So there you have a few simple examples of passing Paypal button variables.
I didn't even touch on IPN (instant payment notificaitons), but there is more you can do with that.
How are you using Paypal buttons? Are there any further configurations that you use to send or receive Paypal button variables?
** This article may contain affiliate links. Please read the affiliate disclaimer for more details.