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

# Checkout

> Generate a temporary wallet to receive one-time payments from your customers.

### Checkout APIs

Embedly Checkout service enable you to create temporary wallets that let customers securely transfer funds into your ecosystem. These wallets are ideal for scenarios like order payments, ticketing, donations, or any situation where you need to collect funds without provisioning a permanent wallet.

Each checkout wallet is:

* **Time-bound** – Expires after a set period
* **Event-driven** – Created in response to a specific action or event

This approach enhances security, minimizes risk, and gives you greater control over the transaction flow.

<Info>
  ### Checkout Base URL

  The base URL for all checkout API requests on the staging environment is:

  ```http theme={null}
  https://checkout-staging.embedly.ng/
  ```

  The base URL for all checkout API requests on the production environment is:

  ```http theme={null}
  https://checkout-prod.embedly.ng/
  ```
</Info>

#### Staging

For testing on the staging environment, use the general credentials below.

1. **OrganizationId:** `02600494-1a3c-11f0-a818-6045bd97b81d`

2. **API Key:** `BSK-sqg0f3hCF3sC2KGtNBVsfxbOFFaiOgCEraaCYmg6G0EsqUQ9ihAbeIE2FkAvFlBtIv4kecDVsy4H`

3. **Organization Prefix Mapping Id:** `8b4432bc-f3c7-4055-b5e5-e232707e79af`

## How Does It Work?

<ol>
  <li>
    Creating a Checkout Wallet: This generates a temporary wallet tied to a
    specific transaction or purpose.
  </li>

  <Info>
    Each checkout wallet is designed to receive a single payment and can be
    monitored. This simplifies reconciliation and improves user experience.
  </Info>

  <li>
    Retrieving Wallets by Organization: With your organization's ID, you are
    able to view all generated checkout wallets. This helps in tracking active,
    expired, or used wallets and managing customer payments.
  </li>
</ol>

## Common Questions

<ul>
  <li>
    <strong>How Long Does a Checkout Wallet Last?</strong> The lifespan of a
    checkout wallet is 30 minutes.
  </li>

  <li>
    <strong>Is a Customer Required to Create an Account?</strong> No, checkout
    wallets are designed to collect payments from customers without requiring
    full wallet onboarding.
  </li>

  <li>
    <strong>How do I verify that a payment has been made?</strong> We send
    notifications once credit is received into a checkout wallet within the 30
    minutes from the time of generation. Click
    [here](https://developer.embedly.ng/api-reference/webhooks) to see sample
    payloads for the notifications sent for different checkout payment events.
  </li>
</ul>

## Tips for Using the Service

* Initiate Just-in-Time: Only create checkout wallets when the customer is ready to make a payment, since each wallet expires 30 minutes after creation.

* Track with Metadata on Your Side: Maintain a mapping between your internal references (like order ID or customer ID) and the wallet in your system for reconciliation.

* Monitor for Expiry: If the customer hasn’t paid within the 30-minute window, you’ll need to generate a new checkout wallet. Consider setting up automated reminders or fallback actions.

* Regularly Sync Wallet Status: Use the Get All Checkout Wallets endpoint to check for payments, expired wallets, or unused entries to keep your records up to date.