FAQ

Below are the most common questions you might have when integrating Localpayment Smart Fields. This section is designed to give you quick, reliable answers for both business and technical topics.

---

General

1. What is Localpayment Smart Fields? Smart Fields lets you securely collect card details via hosted iframes served by Localpayment. Sensitive data never touches your servers and is tokenized instantly. Read more in the Overview.

2. How does Smart Fields reduce my PCI DSS compliance scope? Because card data is handled only by Localpayment, you only need to complete the PCI DSS SAQ A questionnaire instead of a full certification.

3. How long does a session last? A session lasts 10 minutes. If it expires, you must initialize a new one before tokenizing. See Integration Guide.

4. Can I use Smart Fields for subscriptions and recurring payments? No. Currently, Smart Fields only supports one-time card payments. Support for subscriptions and recurring payment models is not available at this time.

5. Does Smart Fields support authorization and capture flows? No. Currently, Smart Fields only supports one-time card payments. Authorization and capture (or "Auth & Capture") flows are not available at this time.

---

API Keys & Setup

6. How do I generate Stage and Production API Keys? Log into the Dashboard → Payins → Checkout → Smart Fields API Keys. Create a key per environment (Stage/Production). See Integration Guide.

7. Can I generate multiple API Keys for different applications? Yes. You can create, enable/disable, and delete multiple keys for different apps or environments.

8. What happens if my domain does not match the registered one? The SDK will throw an error and the session won’t initialize. Make sure your key is configured with the exact domain where Smart Fields is hosted.

---

Fields & Customization

9. Which fields are supported? You can mount fields for card number (PAN), CVV, and expiration date. All fields are PCI-secure.

10. Can I customize placeholders, styles, or max length? Yes. Use the options object when creating fields to customize placeholders, CSS styles, and input restrictions. See API Reference.

11. What language are fields displayed in? Currently, Smart Fields are available only in English.

---

Tokenization & Payments

12. What is a card token? It’s a secure, short-lived reference (10 minutes) to the card data, returned after tokenization. You send this token to your backend to complete the payment.

13. Can I reuse a card token for future payments? No. A card token is single-use and cannot be reused for future payments. It remains valid for up to 10 minutes or until it has been used in a transaction, whichever comes first. See Integration Guide.

14. How do I process payments after receiving the token? Send the card token from your frontend to your backend, then call Localpayment’s Payins API. See Integration Guide.

15. How do I test my integration before going live? Use the Stage environment and the provided Test Card Numbers. You can also simulate errors like expired sessions or invalid fields.

Support & Further Information

If you need more help with Smart Fields, you can:

• Review the Overview for a high-level introduction to how Smart Fields works.

• Follow the Integration Guide for step-by-step setup instructions.

• Explore the API Reference for detailed parameters and events.

• Test your integration in a safe environment using Testing & Demos.

For more information, visit our Localpayment Support Center.