PayPal Adaptive Payments with single item - paypal

I have developed a small API that uses PayPal Adaptive Payments to create a chain payment.
Here is my current JSON body that I send to PayPal:
{
actionType: "PAY",
currencyCode: currency_code,
feesPayer: "SECONDARYONLY",
memo: product_name,
receiverList: {
receiver: [{
amount: payment_amount,
email: primary_email,
primary: true
}, {
amount: payment_amount-(0.03*payment_amount),
email: secondary_email,
primary: false
}]
},
returnUrl: "http://example.com/payment-success",
cancelUrl: "http://example.com/payment-cancel",
requestEnvelope: {
errorLanguage: "en_US"
},
trackingId: product_id
}
It works perfectly. The full amount is sent to the primary user, and then 97% of the full amount is sent to the secondary user.
Although, I would like to each of my items so that their quantity is always 1. My site is dynamic and allows users to create items all the time with their own price, name, etc. I would like to mark the item as purchased on my site after someone checks out with PayPal so that no one can buy it again, hence removing the purchase button.
I understand how to do that with Webhooks (provided by PayPal), although what if two or more users press the purchase button on my website and are checking out with PayPal at the same time?

You would need to put your own contorl over the concurrency in this case, as PayPal does not provide this uniqueness validation upon payment attempts in adaptive payments.
Here's how you may put the control in the front-end
Generate a unique invoiceId for each dynamic purchase button on the front-end
Collect the payment details (recievers, amount, invoiceID, etc) with your purchase button, and post the payloads to your API action page (when user submit the purchase button).
In your API action page, validate & save (into database) the invoiceId field to avoid duplicated puschase attempts (placing a status of ordered), and then invoke the PayPal pay API call to generate the PAY-KEY. Put the invoiceId in the payload:receiver object for tracking purpose in the PayPal callback and transaction reports:
receiverList: {
receiver: [{
amount: payment_amount,
email: primary_email,
invoiceId: uniqueId,
primary: true
}, {
amount: payment_amount-(0.03*payment_amount),
email: secondary_email,
primary: false
}]
},
Buyer is redirected with the PAY-KEY and completes the transaction
Webhook/IPN triggered and you'd mark your database entry as purchased
Note on Step#3,
In this flow there're actually 3 status of your purchase button: 1-available, 2-ordered, 3-purchased, this way you have control over it always as a single purchase
Incase buyer drops off(canceling or AFK or closing browser) in Step#4, you may clear the ordered status after 3 hours (PayPal PAY-KEY lifecycle)

Related

Paypal: How to associate checkout id in the responde with the transaction id in the dashboard?

I am doing the simple integration of paypal buttons on my website, using javascript.
I got a reply, using sandbox, like this
create_time: "2020-04-22T09:23:59Z"
id: "3Y914122MY820580S"
intent: "CAPTURE"
links: [{…}]
payer:
address: {country_code: "IT"}
email_address: "sb-yuz43i687312#personal.example.com"
name: {given_name: "John", surname: "Doe"}
payer_id: "PAV4AZG5BTYE2"
purchase_units: [{…}]
status: "COMPLETED"
update_time: "2020-04-22T09:24:23Z"
Also, opening the links array, I have only the following, with same id
"https://api.sandbox.paypal.com/v2/checkout/orders/3Y914122MY820580S"
But, opening the sandbox dashboard of receiving paypal acocunt i see this
How can I associate the checkout id 3Y914122MY820580S with the transaction id 289895873G149713E ?
I have the need to save into db something to be able to verify the paypal transaction in a future moment.
I discovered the code I need more deeply nested.
Having json_result the json data returned from Paypal, in cas of success, of course, the Id of payment can be found at
json_result->purchase_units[0]->payments->captures[0]->id
It can be succesfully used in a link of type
https://www[.sandbox].paypal.com/activity/payment/<id>
So merchant can easily see transaction details

PayPal Checkout Smart Payment Button use Custom Payee

Hi I have successfully Integrated PayPal Checkout Smart Payment Buttons, where i am using custom payee reference https://developer.paypal.com/docs/checkout/integration-features/custom-payee/
My point is if the custom payee email is invalid still the payment completes and the fund goes to the account of the API credentials owner. But I don't want that. IF custom payee email is wrong the payment should not be successful, it must throw a error with proper message so i can catch the error.
I didn't get any solution from paypal docs.
if the custom payee email is invalid still the payment completes and the fund goes to the account of the API credentials owner
What do you mean by 'invalid'? Please be specific about your meaning.
If the email is not associated with an existing PayPal account, the payment will be in a pending state. The owner has 30 days to create a PayPal account using that email (or add it to an already existing PayPal account) and accept the pending payment. If they do not do so within 30 days, the payment will be automatically refunded. In this scenario, it is not the case that "the fund goes to the account of the API credentials owner". That is not happening.
Now, if you are trying to pass a payee object at payment setup time with a blank / empty string email_address, then it will just be ignored, and the payment will go to the API credentials owner as per normal payment processing w/o a custom payee.
So, you need to do your own validation to ensure the payee field is non-blank. You could simply check that it is a non-empty string.
Or, do one better, and actually check that it is an email address in a valid format:
function isEmail(y) {
var re = /^(([^<>()\[\]\\.,;:\s#"]+(\.[^<>()\[\]\\.,;:\s#"]+)*)|(".+"))#((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/;
return re.test(String(y).toLowerCase());
}
If it is not valid, you should not allow the order creation to proceed using that non-valid custom payee, since it will obviously not create the transaction you wish. Instead, you should display an error that the checkout is not set up properly for this user/recipient/payee.
<script src="https://www.paypal.com/sdk/js?client-id=XXXXXXXXXX"></script>
paypal.Buttons({
createOrder: function(data, actions) {
return actions.order.create({
purchase_units: [{
amount: {
value: '1.00'
},
payee: {
email_address: 'someemail#somedomain.com'
}
}]
});
},
onApprove: function(data, actions) {
// This function captures the funds from the transaction.
return actions.order.capture().then(function(details) {
//success
},
onCancel: function (data) {
//cancel payment
}
}).render('#paypal-button-container');
Here the payee email is not exists and fund goes to api owner

How to set category for PayPal Smart Buttons?

When I view the transaction details in Paypal sandbox as buyer, it says "Category: flights".
Is it possible to change that - or is this automatically determined by Paypal? (The documentation only knows about item category physical/digital, but setting this value doesn't change anything.)
My code:
actions.order.create({
purchase_units: [{
"items":[
{"name":"ARGENTINISCHES H\u00dcFTSTEAK","unit_amount":{"currency_code":"EUR","value":"12.50"},"quantity":1,"sku":"FG_001"},
{"name":"Beilagensalat","unit_amount":{"currency_code":"EUR","value":"3.50"},"quantity":1,"sku":"FG_008"}
],
"amount":{
"currency_code":"EUR",
"value":"16.00",
"breakdown":{"item_total":{"currency_code":"EUR","value":"16.00"}}
}
}],
application_context: {
payment_method: {payee_preferred: "IMMEDIATE_PAYMENT_REQUIRED"},
shipping_preference: "NO_SHIPPING"
}
});
This is an account setting, not an integration issue.
You can try editing the category of the sandbox Business account you are receiving the payment with, via https://www.sandbox.paypal.com/businessmanage/account/aboutBusiness -> Update
But since it's sandbox, you can also just not worry about it. The setting in sandbox will not have any relation to any live account this integration ever processes payment with.

Include a message/note field in a PayPal API payment

I am building a really simple payment form where the user can enter an amount and a thank you message. I have got it successfully working with just the amount but I cannot get add a message field and get it to come through!
Here is just the payment function of my JavaScript:
payment: function(data, actions) {
return actions.payment.create({
payment: {
transactions: [
{
amount: {
total: window.transactionAmount,
currency: 'GBP'
},
note_to_payee: document.getElementById('custom-message').value,
description: 'A gift to Martin.',
custom: 'This is a test custom field',
payee: {
"email": "martin#[hidden].com"
}
}
]
},
experience: {
input_fields: {
no_shipping: 1,
allow_note: true
}
}
});
},
I have tried setting custom and note_to_payee but neither seem to be recorded on either the notification email or the data that is logged in the recipient's account.
I have also tried turning on the ability for the payer to add a note by setting allow_note: true in the experience config but that does nothing!
Please help, just any way of passing through a little message with the payment is all I need.
It took PayPal Support team 4 days to come back with the answer that No, it cannot be done.
Here's their full response:
With regard to your request, I have to inform you that "note to seller" (allow_note:true) field is only available in the older PayPal payment experience, and is not available in the newer payment experience.
Unfortunately, there's nothing the caller can do at this time to force an old or new experience and we recommend to collect this information in your website where possible.
So it looks like they've dropped one of the nicest and most simple features of the PayPal checkout which was the ability to include a friendly little note.
Now, my only option is to build a whole back-end system with API end-points and extend my JavaScript just to record my payer's note. Meanwhile, every email notification I receive will continue to contain that annoying lie: "The buyer hasn't entered any instructions".
PayPal: Please, either implement a feature in your new process or remove/hide the feature! Don't do a half-way job. You take 10% of all my transactions, I expect better.
A workaround for this would be to use an "option variable" to create a textbox in your checkout flow. An example of an option variable would be "os0" and "on0".
Here is an example on our website on how you would implement this: https://www.paypal.com/us/cgi-bin/webscr?cmd=_pdn_xclick_options_help_outside
https://developer.paypal.com/sdk/js/reference/#onapprove
paypal.Buttons({
createOrder: function(data, actions) {
...
},
onApprove: function(data, actions) {
// This function captures the funds from the transaction.
return actions.order.capture().then(function(details) {
// This function shows a transaction success message to your buyer
alert('Transaction ' + transaction.status + transaction.id);
window.location.href = 'https://www.yoursite.com/page.php?trnsid='+ transaction.id;
});
}
}).render('#paypal-button-container');
You can do a redirect onApprove.
If the transaction was completed redirect the user to a page with a FORM THAT GET/capture the transactionID (associate the message with a transaction) and ADD a MESSAGE TEXTAREA so user can send some notes after payment.

PayPal Item(s) w/ Description on Review Page

Using the PayPal REST api, I'm passing in this to new payments:
transactions: [
{
amount: {
total: "10.00",
currency: "USD",
details: {
subtotal: "10.00"
}
},
description: "My item description."
}
],
Snippet of the actual request
On the PayPal approve page, though, only the subtotal is displayed - nowhere does the description show up, nor do individual item listings - only the subtotal in USD shows up.
How can I make individual items with descriptions in the REST API checkout? I'm using &useraction=commit by the way.
You would need to pass over the line items in the SetExpressCheckout API call that you are making. There is a list of variable that can be passed over in the developers guide. I have checked with our engineers, and this feature has not been pushed live yet. Line items will be supported, but the feature is not yet live with the New REST API's.