How to set up Books and take PayPal payments
Use this guide to set up Books in Ansel Forms and take PayPal payments from your forms. Each step shows what to fill in and tells you if it is needed or optional.
Step 1: Add your name or company name (needed)
Open Books, then Settings, then Company. Type your company name. If you are a freelancer, type your own name. This name prints on every invoice and quote.
Email, address, phone, tax number, bank details and logo are optional. Add them if you want them on your documents.
Step 2: Set tax and item codes (optional)
There is no tax list to build. You add tax on each item line with a name and a percent, like VAT 5. Here you only choose if your prices are tax exclusive (tax added on top) or tax inclusive (tax already inside).
Step 3: Choose your numbering (optional)
Pick the start of each number and the next number. For example, INV and 47 gives INV0047. Most people keep what is already there.
Step 4: Set your currency and dates (optional)
Your currency starts as USD. To change it, type a 3 letter code like AED or EUR. Then pick your date format and the days a customer has to pay.
Important: Online payment only works with a 3 letter currency code.
Step 5: Design your documents (optional)
Pick a colour, a footer text, a default note and default terms. All your invoices and quotes use this one clean layout.
Step 6: Add your items
Open Books, then Items, and add a product or a service. Set a sale price above zero. An order with a total of zero skips the payment step.
In Unit, type a word like pcs or kg, not a number. Tick Count the stock of this product only if you want the stock to go down with each sale.
Selling on a website? Link your Xexea shop and orders become invoices.
Step 7: Get your PayPal keys
Go to developer.paypal.com and log in. Open Apps and Credentials. Choose Sandbox to test with pretend money, or Live for real payments. Create an app of type Merchant. Copy the Client ID and the Secret. Share keys with your team only in a self destructing note.
Important: PayPal has rules for each country. For example, a PayPal account in India can take payments only from customers outside India. Check the PayPal rules for your country.
Step 8: Save your PayPal keys in Integrations
In Books, open Settings, then Integrations, and find the PayPal box. Choose Sandbox or Live. Under Step 1, paste the Client ID and the Secret. Press Save.
Step 9: Add the PayPal webhook
After you save, Step 2 in the PayPal box shows your webhook address. Copy it. In your PayPal app, add a webhook with that address and tick two events: Checkout order approved and Payment capture completed.
PayPal then shows a Webhook ID. Paste it into the Webhook ID box in Ansel Forms and press Save. The PayPal box should now say On.
Step 10: Make an order form
Create a form with a name field, an email field and a Product or Service field. In that field, pick the items you added before. Need help? Read how to create a form.
Step 11: Link the form as an order (needed)
Open Settings, then Linked forms. Choose your form. Under Each answer creates, pick An order. Match the name and email fields and save.
Important: If the form is linked as an enquiry, no payment is asked. It must be linked as An order.
Step 12: Test your first payment
Open your form, choose a product and send it. You will see the PayPal buttons. Your customer can pay with a PayPal account or with a card. No PayPal login is needed for a card.
After paying, the invoice in Books is marked paid. If you count stock for the item, the stock goes down.
Optional extras
Email sending with Brevo
Brevo is optional. Without it, your emails are sent by Ansel Forms. With it, emails go out from your own address.
Automation
Automation is optional too. Books can chase late invoices, send thank you emails and tell you about new orders and low stock. Every rule starts off. Tick only the ones you want.
Books and PayPal questions
Do my customers need a PayPal account?
No. They can pay by card with the Debit or Credit Card button. No PayPal login is needed for a card.
Why does my form not ask for payment?
Check four things. The form is linked as An order. The item price is above zero. Your currency is a 3 letter code like USD. PayPal says On in Integrations.
Which settings are needed and which are optional?
Only two things are needed: your name or company name, and one linked form. Tax, numbering, currency, design, Brevo and automation are all optional.
How do I test without real money?
Use Sandbox keys from developer.paypal.com. Pay with a sandbox buyer or a sandbox test card. No real money moves.
How do I go live?
Create a Live app in PayPal and add the webhook again for Live. Then choose Live in Integrations and save the new keys and the new Webhook ID.
Can I use PayPal in every country?
PayPal has rules for each country. For example, a PayPal account in India can take payments only from customers outside India. Check the PayPal rules for your country.
Are my PayPal keys safe?
Yes. Your keys are stored encrypted and can not be seen again after saving.
Which plan do I need?
Books and online payments are part of the Enterprise plan.