---
updatedAt: 2026-02-02T21:52:50.000Z
agentTools:
siteIndex: https://docs.affirm.com/llms.txt
projectIndex: https://docs.affirm.com/payments/llms.txt
---
# Set Up Split Capture
Easily integrate Affirm Split Capture to offer flexible payment options, customize the experience to match your brand, and ensure a smooth, secure checkout for your customers.
{`
`}
## Prerequisites
* Set up your [Affirm account](https://www.affirm.com/dashboard/signin) to access to your merchant account credentials.
## Steps
### 1. Add Affirm.js
Add the Affirm.js script to the `` on your site. The script loads directly from the Affirm domain.
> 🚧 Sandbox API Keys
>
> Use only your sandbox API keys and domain during testing and development. This ensures that you don't accidentally modify live transactions.
```javascript
```
Adding `Affirm.js` creates a defined instance of Affirm on your client. This grants you access to the following methods within the Affirm object to trigger multiple actions:
* `affirm.checkout({ })` - Stores the checkout object and is used for the checkout request payload.
* `affirm.checkout.post()` - Sends the checkout object via `POST` request.
### 2. Initiate checkout
Create a checkout object and launch the checkout process with the Checkout function. Rendering the Affirm checkout enables your customers to use Affirm to pay for purchases on your site.
```javascript
affirm.checkout({
"merchant": {
"user_confirmation_url": "https://merchantsite.com/confirm",
"user_cancel_url": "https://merchantsite.com/cancel",
"user_confirmation_url_action": "POST",
"name": "Your Customer-Facing Merchant Name"
},
"shipping":{
"name":{
"first":"Joe",
"last":"Doe"
},
"address":{
"line1":"633 Folsom St",
"line2":"Floor 7",
"city":"San Francisco",
"state":"CA",
"zipcode":"94107",
"country":"USA"
},
"phone_number": "4153334567",
"email": "joedoe@123fakestreet.com"
},
"billing":{
"name":{
"first":"Joe",
"last":"Doe"
},
"address":{
"line1":"633 Folsom St",
"line2":"Floor 7",
"city":"San Francisco",
"state":"CA",
"zipcode":"94107",
"country":"USA"
},
"phone_number": "4153334567",
"email": "joedoe@123fakestreet.com"
},
"items": [{
"display_name": "Awesome Pants",
"sku": "ABC-123",
"unit_price": 1999,
"qty": 3,
"item_image_url": "http://merchantsite.com/images/awesome-pants.jpg",
"item_url": "http://merchantsite.com/products/awesome-pants.html"
"categories": [
["Home", "Bedroom"],
["Home", "Furniture", "Bed"]
],
}],
"shipping_amount": 1000,
"tax_amount": 500,
"total": 5997
});
affirm.checkout.open()
```
> 📘 Create a Checkout Object
>
> You can find more information on how to [create a checkout object](https://docs.affirm.com/payments/docs/create-a-checkout-object) via our Affirm Javascript library.
### 3. Add the checkout button
Add the pre-styled checkout button. For details, see Checkout Button .
### 4. Handle callbacks
After you initiate a checkout and the customer confirms their Affirm loan, we send an HTTP request with the `checkout_token` to the URL you defined in the checkout object (`user_confirmation_url`).
By default, we send this request via `POST`. You can configure the checkout object so that we send this request via `GET`.
To choose how we send the `checkout_token`, you can set the `user_confirmation_url_action` parameter in the checkout object to:
* `POST` to send the `checkout_token` in the body of the HTTP request (default setting).
* `GET` to send the `checkout_token` in the query string of the HTTP request.
### 5. Create a transaction
When a customer successfully completes a checkout, it’s recorded as a new purchase attempt. This must be handled on your server-side to be fulfilled by our [Transaction API](https://docs.affirm.com/payments/reference/transaction-api-endpoints).
## What’s Next?
* [API Reference](https://docs.affirm.com/developers/reference/introduction)
* [Promotional Messaging and Prequalification](https://docs.affirm.com/developers/docs/about-promotional-messaging-and-prequalification)
* [Managing Split Capture Transactions](docs.affirm.com/developers/docs/split-capture-transactions)
# Sub pages
* [API Reference for Split Capture](https://docs.affirm.com/payments/docs/split-capture-api-reference.md)
# Sibling pages
* [About Direct API](https://docs.affirm.com/payments/docs/direct-api-overview.md)
* [Set Up Direct API](https://docs.affirm.com/payments/docs/transactions-web.md)
* [Inline Integration Overview](https://docs.affirm.com/payments/docs/inline-integration.md)
* [About Split Capture](https://docs.affirm.com/payments/docs/split-capture.md)
USA
Canada