Create your first payment with the SDK

This ~5-minute guide uses the Bob server SDK to create a PIX charge and confirm your first payment in the sandbox.

You need an sk_test_ key. If you don’t have one yet, see Set up your account.

Install the prerequisites

You need Node.js 20 or 22 (LTS).

node --version   # v20.x or v22.x

Create the project and install the SDK

mkdir bob-first-payment && cd bob-first-payment
npm init -y
npm install @bobpayments/sdk

Configure the API key

Create a .env file in the root with your sandbox key:

BOB_API_KEY=sk_test_your_key

The sk_test_ key is secret and lives on the backend only. Never send it to the browser.

Create the PIX charge

Create a checkout session with PIX. The response includes the checkoutUrl you redirect the buyer to:

import { BobPayments } from '@bobpayments/sdk';

const bob = new BobPayments({ apiKey: process.env.BOB_API_KEY! });

const session = await bob.checkoutSessions.create({
  amountCents: 10_000, // in the sandbox, an amount ending in .00 is paid automatically
  items: [{ name: 'Premium Plan', quantity: 1, unitAmountCents: 10_000 }],
  paymentMethods: ['pix'],
  successUrl: 'https://store.example.com/order/success',
  webhookUrl: 'https://store.example.com/webhooks/bob',
});

console.log(session.checkoutUrl); // redirect the buyer here

Make your first payment

In the sandbox, the outcome is controlled by the last two digits of the amount — no real PIX needed:

Amount cents	Outcome
`.00` (e.g., `10000`)	Paid in ~5s (`transaction.paid`)
`.01` (e.g., `10001`)	Expires in ~5s (`transaction.expired`)
`.02` (e.g., `10002`)	Stays pending until it expires

Since the session above uses 10_000, the payment is confirmed within seconds and fires the transaction.paid webhook.

Check the payment in the Dashboard

Go to Transactions at app.payments.bob.company and see the just-paid charge, with the isSandbox: true field.

Next steps

Understand the flow

See how session, transaction, checkout, and webhook connect.

Configure webhooks

Implement asynchronous confirmation on your server.

Test in the sandbox

Simulate payment states without moving real money.

See all paths

Compare hosted checkout, Checkout SDK, and direct API.

Getting Started

Core concepts

Integration methods

Webhooks

Using Bob

API fundamentals

Create your first payment with the SDK

Next steps

Understand the flow

Configure webhooks

Test in the sandbox

See all paths

​Next steps

Understand the flow

Configure webhooks

Test in the sandbox

See all paths

Next steps