Skip to main content
GET
/
payments
Get shop payments
curl --request GET \
  --url https://store.salesive.com/api/v1/payments \
  --header 'Authorization: Bearer <token>' \
  --header 'x-shop-id: <api-key>'
{
  "status": 123,
  "success": true,
  "message": "<string>",
  "data": "<array>"
}

​
Request

GET /payments
Authorization: Bearer {{token}}
x-shop-id: {{shopId}}

​
Headers

HeaderTypeDescription
AuthorizationstringProvide the customer token as Bearer <jwt>.
x-shop-idstringIdentify the shop.

​
Successful response

{
    "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

{
    "status": 404,
    "success": false,
    "message": "Shop not found",
    "data": {}
}

Authorizations

​
Authorization
string
header
required

JWT issued by the Salesive Store API for authenticated shoppers.

​
x-shop-id
string
header
required

Optional storefront identifier sent as a header to scope responses to a specific shop. Try It requests remember this value once provided.

Headers

​
x-shop-id
string

Optional identifier that scopes responses to a specific storefront when the referer cannot be inferred.

Response

200 - application/json

Payment methods retrieved

​
status
integer
​
success
boolean
​
message
string
​
data
array