> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dintero.com/llms.txt
> Use this file to discover all available pages before exploring further.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.dintero.com/feedback

```json
{
  "path": "/docs/checkout/postman-checkout-guide",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# Postman guide for Dintero Checkout

> Test the Dintero Checkout API in Postman — set up your API client, get an access token, create payment sessions, and run common requests end to end.

## Prerequisites

* Merchant account [signup]
* Create [Checkout API client] via [Dintero Backoffice]
* Session profile. Login to [Dintero Backoffice] → Settings → Payment Profiles
* Download or log in to [Postman]

## First steps

Download these files:

* <a target="_blank" href="/mintlify-docs/postman/checkout.postman.v1.0.json">Postman Collection</a>
* <a target="_blank" href="/mintlify-docs/postman/checkout.postman.env.sandbox.v1.0.json">Sandbox Environment</a>

When Postman is opened, import the Postman Collection using the `Import`-button in the upper left corner.

Now, go to **Manage Environments**, and import the Sandbox Environment.

Now, edit the Sandbox Environment with the properties that are unique to you:

* **Client\_Id** (e.g. **13246c33-6b84-423c-9a12-21db98a29424**)
* **Client\_Secret** (e.g. **b8ab258b-461e-4cf3-b425-ba6631027d9d**)
* **Account\_Id** (e.g. **T41112484**)

Make sure you use credentials from the sandbox/test-environment, and an accountId prefixed with a `T`.

You can also set a payment profile id, see prerequisites.

* sessionProfileId

This should also be prefixed with a `T`.

## Fetching a token

Now, you should be able to fetch a token. Go to the `Get Token`-request and push the **Send-button**.
If everything goes well, you'll get an access\_token that you can use for calls to the Checkout API.

## Create a session

Go to **Create a checkout session**. You can edit the body if you want to, and then push **Send**.
A session will be created, and you will get a URL that you can use to pay it.

You can also create a session using the **Create checkout session from profile** if you've configured the `sessionProfileId` variable.

You can cancel the session using the `Cancel session`-request before paying.

## After paying

When the session is paid, use the **Get checkout session details**-request to see the status of the session.

If the payment succeeded, there should be a `transaction_id`-property on the session. This will be saved as an environment variable in Postman.

You can now fetch the transaction using the **Get a transaction**-request. You can also void it, capture it and make a refund after capturing.

## Further

To customize your requests, check out the [checkout api] for all the possibilities.

[signup]: https://onboarding.dintero.com

[Dintero Backoffice]: https://backoffice.dintero.com

[checkout api]: /payments-api.html

[Checkout API client]: /docs/checkout/checkout-client

[Postman]: https://www.postman.com/