Skip to content

Checkout

Choose a checkout path that fits your team

Hosted checkout, payment links, embedded forms or Smart Fields. Less card data on your servers.

  • No-code options
  • Hosted card fields
  • Single-use tokens
Checkout options on the same pay-ins platform
4
Payment links you share by email, SMS or chat
No code
Hosted card fields that reduce your PCI scope
Smart Fields
Where you configure appearance, catalog and keys
Business Portal

Smart Fields

From card entry to payment in four steps

  1. 01

    Load the SDK

    Include localpayment-sdk.min.js and initialize it with your client code and Smart Fields API key.

  2. 02

    Mount the fields

    Create the pan, cvv and expiration fields and mount them into your form containers.

  3. 03

    Consolidate

    Your backend exchanges the session ID for a single-use token through the consolidate endpoint.

  4. 04

    Charge

    Create the payin with the token instead of card details. Raw card data never reaches your servers.

For developers

Turn a Smart Fields session into a payment

In the browser, the SDK collects card data in hosted fields and gives you a session ID. On your server, exchange it for a single-use token and create the payin.

  • Stage SDK: sdk.stage.localpayment.com/localpayment-sdk.min.js
  • Single-use tokens, one per payment
  • Same Create Payin endpoint as every other method
# Illustrative — Stage endpoints, fictitious values; see the Smart Fields guide
# 1) Exchange the Smart Fields session for a single-use token
# LP_TOKENIZATION_URL: tokenization host for your environment (see the Smart Fields guide)
curl -X POST "$LP_TOKENIZATION_URL/api/tokenization/consolidate" \
  -H "Authorization: Bearer $SESSION_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "clientCode": "<your-client-code>",
    "sessionId": "<session-id-from-the-sdk>",
    "CardholderName": "Lucía Méndez"
  }'

# 2) Create the payin with that token
curl -X POST https://api.stage.localpayment.com/api/payin/ \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "paymentMethod": { "type": "CreditCard", "code": "1904", "flow": "DIRECT" },
    "externalId": "a41d7e20-0000-4000-8000-000000000077",
    "country": "COL",
    "currency": "COP",
    "amount": 185000,
    "accountNumber": "<your-account-number>",
    "conceptCode": "0001",
    "merchant": { "type": "COMPANY", "name": "Comercio Ejemplo S.A.S." },
    "payer": {
      "type": "INDIVIDUAL",
      "name": "Lucía",
      "lastname": "Méndez",
      "document": { "type": "CC", "id": "1000000000" }
    },
    "card": { "token": "<single-use-token>" }
  }'

Make it yours

Configure checkout from the Business Portal

Appearance, catalog and keys live in one place, so operations teams can adjust checkout without a deploy.

  • Set the brand color of the embedded iframe and payment links
  • Save frequent items for WebCheckout and payment links
  • Manage iframe keys and Smart Fields API keys
  • Track every payment in the same reports as your API traffic

Use cases

The right checkout for each sales channel

Frequently asked questions

Which checkout option should I start with?

Many businesses start with payment links or WebCheckout because they need no integration, then move to the embedded iframe or Smart Fields as their checkout matures.

What does PCI scope mean for my team?

It’s the part of your systems subject to PCI DSS requirements. Hosted options keep card data with us, which reduces that scope; your QSA confirms your final obligations.

Which payment methods do the hosted options support?

WebCheckout takes credit cards, debit cards and bank transfers. Payment links and the embedded iframe show the payment methods enabled for your account, including cards and bank transfers. Smart Fields collects card data only.

Do I need a server SDK?

No. There are no official server SDKs — your backend calls the REST API directly. Smart Fields uses a client-side JS SDK.

Can I test before going live?

Yes. Smart Fields and the other checkout options can be tested on Stage, which mirrors production with no real money.

Can I brand the hosted checkout?

Yes. From the Business Portal you set the brand color of the embedded iframe and payment links, with no code changes.

How long is a payment link valid?

The customer must pay within 8 hours of first opening the link. After that it expires, and you send a new link to collect.

Pick your path and go live

Start with a link today and grow into a fully native checkout when you’re ready.

How can we help?

Download your copy

Leave your details and get the full edition instantly.