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

# Get shop payments

> Retrieve payment methods configured for the shop.

## Request

```http theme={null}
GET /payments
Authorization: Bearer {{token}}
x-shop-id: {{shopId}}
```

## Headers

| Header          | Type   | Description                                   |
| --------------- | ------ | --------------------------------------------- |
| `Authorization` | string | Provide the customer token as `Bearer <jwt>`. |
| `x-shop-id`     | string | Identify the shop.                            |

## Successful response

```json theme={null}
{
    "status": 200,
    "success": true,
    "message": "Shop payments retrieved",
    "data": [
        {
            "_id": "6938c8079b2e99d3eed7d2bc",
            "paymentOption": {
                "_id": "691babda8ad2962ff0fedbf2",
                "id": "flutterwave",
                "name": "Flutterwave",
                "description": "Empowering businesses of all sizes with seamless payment solutions.",
                "active": true,
                "type": "gateway",
                "image": "https://res.cloudinary.com/computer-geek/image/upload/v1763288769/Salesive/payment/favicon_orlll4.ico",
                "currencies": ["NGN"],
                "website": "https://flutterwave.com"
            },
            "shop": "68b8f52575da81b332af29f1",
            "type": "gateway",
            "active": true,
            "settings": {},
            "createdAt": "2025-12-10T01:08:23.893Z",
            "updatedAt": "2025-12-28T03:06:16.001Z"
        },
        {
            "_id": "6938b9569b2e99d3eed7c102",
            "paymentOption": {
                "_id": "691babda8ad2962ff0fedbf4",
                "id": "transfer",
                "name": "Transfer",
                "description": "Bank Transfer payments",
                "active": true,
                "type": "transfer",
                "image": "https://cdn-icons-png.flaticon.com/128/1990/1990568.png",
                "currencies": ["NGN"]
            },
            "shop": "68b8f52575da81b332af29f1",
            "type": "transfer",
            "active": true,
            "settings": {
                "accountNumber": "1223456789",
                "accountName": "Store Account",
                "bankCode": "100004",
                "bankName": "Opay",
                "bankId": "2260"
            },
            "createdAt": "2025-12-10T00:05:42.331Z",
            "updatedAt": "2026-01-13T00:03:52.067Z"
        }
    ]
}
```

## Error response

```json theme={null}
{
    "status": 404,
    "success": false,
    "message": "Shop not found",
    "data": {}
}
```


## OpenAPI

````yaml GET /payments
openapi: 3.1.0
info:
  title: Salesive Store API
  description: >-
    REST interface for querying products, categories, and merchandising banners
    exposed by Salesive storefronts.
  version: 1.0.0
servers:
  - description: Production
    url: https://store.salesive.com/api/v1
security:
  - BearerAuth: []
    ShopIdHeader: []
paths:
  /payments:
    get:
      summary: Get shop payments
      description: Retrieve payment methods configured for the shop.
      parameters:
        - $ref: '#/components/parameters/XShopIdHeader'
      responses:
        '200':
          description: Payment methods retrieved
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                  success:
                    type: boolean
                  message:
                    type: string
                  data:
                    type: array
components:
  parameters:
    XShopIdHeader:
      name: x-shop-id
      in: header
      description: >-
        Optional identifier that scopes responses to a specific storefront when
        the referer cannot be inferred.
      required: false
      schema:
        type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT issued by the Salesive Store API for authenticated shoppers.
    ShopIdHeader:
      type: apiKey
      in: header
      name: x-shop-id
      description: >-
        Optional storefront identifier sent as a header to scope responses to a
        specific shop. Try It requests remember this value once provided.

````