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

# Overview

> Integrate Payment Links using TransactBridge.

### 🔗 Payment Links (Create Billing Session)

You can generate a unique payment link for a customer using the Billing Session API.
This works similarly to payment link providers like Cashfree, where a secure checkout URL is generated and shared with the customer.

### 🧭 Payment Flow

In this flow, the customer will be redirected first from the partner's website to a domain hosted by Transact Bridge where the customer will enter the requisite information (depending on what compliances) to make payment, and after making payment the customer will be redirected back to the partner's website. The redirection URL will be provided in response to the [Create Session API](https://docs.transactbridge.com/#d4607171-457b-4d24-8277-6d9a79a997dd) requests.

1. Merchant calls Create Billing Session API
2. Transact Bridge returns a checkout URL
3. Merchant shares link with customer
4. Customer completes payment
5. Webhook is triggered
6. Customer is redirected to `returnUrl`

### How to get session url

You can obtain the session url by creating a billing session using the Transact Bridge Sessions API. This API allows you to generate a unique payment session for one-time payments. Refer to the API documentation below for request structure, required parameters, and response details.

**For full flow reference:**

<Card title="One Time Payment API Docs" icon="code" href="https://docs.transactbridge.com/#a393206c-8fae-4f1f-a55f-01b53330ec66">
  View the Postman API Collection
</Card>

### 🚀 Create Payment Link (Billing Session API)

```js theme={null}

POST https://sandbox-api.transactbridge.com/billingSession/v1.0/generateBillingSession

```

### ✅ Required Parameters

| Parameter                      | Type   | Type                                  |
| :----------------------------- | :----- | :------------------------------------ |
| `email`                        | String | Customer email                        |
| `returnUrl`                    | String | Redirect URL after session completion |
| `quoteCurrCode(Currency code)` | String | Currency (USD, EURO, INR, etc)        |
| `items(Product Information)`   | Array  | Product details                       |

### 📦 Sample Request

```json theme={null}
{
  "email": "example@gmail.com",
  "quoteCurrCode": "INR",
  "returnUrl": "https://www.transactbridge.com",(Your website url)
  "userId": "692406f30e7db4832a0a7987",
  "items": [
    {
      "name": "Product name",
      "description": "Product description",
      "amount": 100,
      "quantity": 5,
    }
  ]
}
```