24

1ShoppingCart Email Order Processing

If you’re using 1ShoppingCart or 1SiteAutomation.com (our private label of 1SC), if you want your users to be automatically logged in to their DAP membership area upon completion of purchase, then refer to this documentation on how to setup Login Xpress with 1ShoppingCart.

If you only sell one-time products, then the 1SC Login Xpress is the only thing you will need to integrate DAP and 1SC.

However, if you sell RECURRING products via 1SC, then you need to set up the email parsing of orders to allow DAP to process recurring payment notification from 1SC, as described below.

The reason for this, is that 1ShoppingCart, while very robust as a cart, does not trigger payment notification messages on the backend (like Paypal can do with IPN) when recurring payments comes in for a member.

So, we at DAP have created an exclusive “Email Order Processing” feature, where DAP will log in to your billing email inbox (where your 1SC email notifications come in) and then check your emails as if it were your personal assistant, and then process any orders that match your DAP Product names.

That is how DAP is able to do automated processing of Cancellations and Failed Recurring Payments.

For 1ShoppingCart and ClickBank, DAP does “Email Parsing” of orders.

Setting Up “Email Parsing”

Basically all you will be doing here is telling DAP where your payment notification emails from 1SC come in, and how to go fetch those emails so the recurring payments can be processed automatically, without you having to lift a finger.

1. Log in to your 1SC account. Then go to “Setup > Orders”. Copy the email id that you have entered into the “Order Notice Email – Primary Destination” field. Please note that 1SC DOES NOT send recurring billing notifications to the email id in the “Secondary Destination”. So be sure you use the email id from the “Primary Destination” field.

So let’s say you have set the primary destination email currently, to point to say ‘billing@yoursite.com’. Now make sure that the emails in your billing@yoursite.com inbox remain in ‘Unread‘ status, because when DAP logs in to check your recurring notifications, it will be looking at only Unread emails. It will not touch the ones that are already read.

2. Go to DAP Admin Dashboard > Setup > Config > Payment Integration .

3. On this screen, configure the following fields…

Email Server Where Order Emails Come In : mail.yoursite.com

Email Server Protocol (pop3/imap) : imap (no need to change this)

Email Server Port : 143 (probably won’t need to change this)

Email Server Protocol (ssl/nossl) : nossl (probably won’t need to change this)

Email Server User Name : billing@yoursite.com (enter email id copied from Step #1 above)

Email Server Password : yourpassword (the password to your email inbox for the above email address)

That’s it as far as setup is concerned.

Additional Notes

4. Set up your sales page as you would normally do when accepting payment through 1ShoppingCart. The only thing you need to make sure is to use the exact same “Product Name’ in your cart as well as within DAP.

So, if you set up a product called “My Membership Site” within DAP, then use the same name “My Membership Site” in your 1SC product name.

5. During installation, a Cron job (dap-emailorder.php) would have already been set up in your web hosting cpanel, to run every 10 minutes. So, every 10 minutes, DAP will automatically check the email id specified in Email Server User Name (the email id from Step 1).

If there is a payment notification (first time or recurring payment) for a product name that matches a product name in DAP, then it will automatically add that customer to DAP as a member if they’re a new member, or if they’re an existing member and it was a recurring payment notification, then DAP will “extend” their membership access by a month (or whatever your recurring cycle is), so that they will continue to get access to your membership site until the next payment comes in.

Testing

Try out some test purchases first. Make sure you try out the full purchase and full user experience, end-to-end.

WARNING 1: If you ever change the name of your product in 1ShoppingCart, or within DAP, make sure that both DAP and 1SC Product names are in sync.

WARNING 2: Do not use SKU in 1SC while defining the product. DAP will not parse the emails correctly if you use SKU.

More: Troubleshooting 1ShoppingCart Integration

Click Here to Leave a Comment Below 24 comments
Kenny Salter - November 18, 2009

Is this correct for 1shoppingcart? my order notification emails go to kenny@kennysalter.com. So I put the smtp address for the server that kenny@kennysalter.com is hosted on.

The billing address in this case would be kenny@kennysalter.com since that is where the payment notifications go to.

1shoppingcart notifications don’t include the product name just the order id so how does DAP know who the order is for and what product it is for?

Reply
Ravi Jayagopal - November 18, 2009

Kenny,

>>Is this correct for 1shoppingcart? my order notification emails go to kenny@kennysalter.com. So I put the smtp address for the server that kenny@kennysalter.com is hosted on. The billing address in this case would be kenny@kennysalter.com since that is where the payment notifications go to. << That is correct. >>1shoppingcart notifications dont include the product name
That is not true. They do include the product name. Feel free to email me and I will send you a sample 1SC notification email.

– Ravi Jayagopal

Reply
Kenny Salter - November 20, 2009

Yes, your right I see in the 1SC notification the product description is in the body copy of the email. I was looking for it in the subject line.

Reply
Vatsal Thakker - February 1, 2010

Is there any way to get order id or order information on thank you page in 1shopping cart?
I really appreciate your help.
Thank You.

Reply
Ravi Jayagopal - February 2, 2010

Vatsal,

You mean like you want the order id to be posted to your thank you page?

– Ravi Jayagopal

Reply
Vatsal Thakker - February 8, 2010

Yes Mr. Ravi.
I want to get order id to be posted to my Thank You page.
Thank You in advance.

Reply
Christine Pembleton - February 12, 2010

Is there a way to check the log files to see if this process is running?

Reply
Ravi Jayagopal - February 12, 2010

Christine,

Sure. Go to Admin > Config . Change “Log Level” to “5”.

Then go to “Logs” screen and keep refreshing to see what’s going on.

– Ravi Jayagopal

Reply
Vatsal Thakker - February 15, 2010

-> How to display category vice products in asp.net application from 1shoppingcart website. (API of list of products)?

-> How to get credit card information on thank you page? (1shoppingcart)

-> How to pass custom variables on view cart page?(1shoppingcart)

I really appreciate your help.

Thank You.

Reply
Ravi Jayagopal - February 15, 2010

Vatsal,

Sorry, we’re unable to help you with general technical issues that have nothing to do with DAP.

You should probably ask these questions in some 1SC forum on the web, or msg them on twitter.

– Ravi Jayagopal

Reply
Vatsal Thakker - February 15, 2010

Thank You Mr. Ravi

Reply
Alan Petersen - February 18, 2010

Hello,

Question on using ClickBank as the payment processor.

When a customer orders via ClickBank they won’t have access to the paid membership site until the cron job runs?

So in theory, depending when they paid via ClickBank and when the latest cron job ran, it could take 0-10 minutes for the customer to have access to the product?

I just want to make sure I understand so I can manage customer expectations. Thanks!

–Alan

Reply
Ravi Jayagopal - February 19, 2010

Alan,

>>So in theory, depending when they paid via ClickBank and when the latest cron job ran, it could take 0-10 minutes for the customer to have access to the product?<< That is correct. - Ravi Jayagopal

Reply
Sergiu Simmel - March 3, 2010

There are a couple of important constraints one needs to be aware of when integrating with 1ShoppingCart (1SC):

[1] If your 1SC product has an SKU, your DAP product name must be:

()

One way to avoid this is to NOT use SKUs on the 1SC side. This may be OK for someone who has just a few products, but when the # of 1SC products is in the tens or hundreds (my case), it’s really not practical.

The real solution is for the DAP email parser to take the existence of an SKU in consideration.

[2] It appears that the DAP email parser does not do well with 1SC product names that have ‘:’ (colon) somewhere, such as a product name:

Author: Title

It also appears (haven’t totally tested this one) that the DAP email parser does not do well with 1SC product names that have ‘[‘ and/or ‘]’ in them, such as a product name:

My product [version 2]

MORAL: DAP needs to be fixed to accept whatever 1SC accepts as product name string, with no constraints.

Reply
Sergiu Simmel - March 29, 2010

One more constraint I just discovered recently: The product name cannot be too long. It appears (have not scientifically proven it) that it cannot exceed 50 characters.

Why? Because beyond a certain length, in the notification email from 1SC that DAP parses, the line containing the product name and the price charged breaks into 2 lines, where the price appears on the second line–THAT makes DAP not parse the email correctly.

So if you keep the product name under 45 characters or so, things seem to be fine.

NOTE to DAP Development: In general, whatever 1SC accepts for product name (see also my comment above) should be acceptable by DAP.

Reply
Incu-biz.com - April 14, 2010

So does 1shopping cart send an email notification every month for recurring billing? Or how does dap integrate with 1sc for recurring products.

Reply
Ravi Jayagopal - April 15, 2010

>>So does 1shopping cart send an email notification every month for recurring billing?<< Yes, that is correct. DAP processes the recurring billing email notification to advance the member's access dates by a month. - Ravi Jayagopal

Reply
Jason Ser - July 20, 2010

Is it possible to set up a free membership site, and from within, set up a paid membership via click bank?

Cheers
Jason Ser

Reply
DAP-1SC Login xPress — DAP Documentation - November 8, 2010

[…] But if you sell RECURRING products via 1SC and you also want your users to be automatically signed in to DAP after initial purchase, then continue reading this post for login xPress setup. After setting up login xPress, you also need to set up the email parsing of orders to allow DAP to process RECURRING payment notifications from 1SC as described here. […]

Reply
Chris - October 29, 2011

This is probably a dumb question, but if a product has recurring payments, does it need to be set up as recurring in BOTH 1SC and DAP – or just DAP?

Reply
Veena Prashanth - October 30, 2011

Chris,

>>but if a product has recurring payments, does it need to be set up as recurring in BOTH 1SC and DAP << If you use 1sc, you need to set it up as recurring in 1sc to allow 1sc to charge the user every recurring cycle. You still need to setup the dap product as recurring product. The recurring cycle in dap will be used to 'extend user's access to content/product upon every recurring payment'.

Reply
Troubleshooting 1SC | Digital Access Pass Help - January 13, 2012

[…] Make sure your email orders are being read by DAP in the email order processing instructions. You must have an email account that you can set up in this […]

Reply
David - March 30, 2012

This works…kind of…but with a large membership system becomes very slow as DAP needs to trawl through all emails in our order management inbox. And 1SC won’t allow us to set up separate email addresses for recurring.

I note that another WordPress membership system recently introduced integration with 1SC’s API that triggers recurring payment notifications similar to the way Paypal does with IPN.

Are there any plans to do the same level of integration with DAP and 1SC’s API?

Thank you

Reply
Ravi Jayagopal - March 31, 2012

David,

DAP will not process “read” emails. So simply mark all old emails as “read”. Or you could move emails out of the inbox into a separate folder, so that DAP can’t get to them. Either of those will speed up things.

And yes, we sure will support 1SC’s API notifications at some point. No ETA on that though.

– Ravi

Reply

Leave a Reply: