# Get public payment methods

`GET /v2/payments/payment-methods/public`

**Base URLs:**

- Sandbox: `https://api.sandbox.bobpay.co.za`
- Production: `https://api.bobpay.co.za`

**Authentication:** Bearer token required. Obtain one via `POST /login` (see the Authentication page).

## Example request

```bash
curl -X GET "https://api.sandbox.bobpay.co.za/v2/payments/payment-methods/public" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"
```

This endpoint retrieves the list of payment methods available for a specific account, including their status and display order.

### Request

**Method:** `GET`
**URL:** `https://api.sandbox.bobpay.co.za/v2/payments/payment-methods/public`

#### Query parameters

| Key | Description | Type | Required |
| --- | --- | --- | --- |
| account_code | The unique code identifying the account. | string | Yes |

---

### Response

**Status code:** `200 OK`
**Content-Type:** `application/json`

#### Response body

```json
{
    "payment_methods": [
        {
            "name": "absa-pay",
            "status": "inactive",
            "order": 8
        },
        {
            "name": "credit-card",
            "status": "active",
            "order": 1
        },
        {
            "name": "instant-eft",
            "status": "active",
            "order": 2
        },
        {
            "name": "account-balance",
            "status": "active",
            "order": 0
        },
        {
            "name": "pay-shap",
            "status": "active",
            "order": 4
        },
        {
            "name": "manual-eft",
            "status": "active",
            "order": 3
        },
        {
            "name": "capitec-pay",
            "status": "active",
            "order": 5
        },
        {
            "name": "scan-to-pay",
            "status": "active",
            "order": 6
        },
        {
            "name": "nedbank-direct-eft",
            "status": "active",
            "order": 7
        }
    ]
}
```

---

#### Response fields

| Key | Description | Type |
| --- | --- | --- |
| payment_methods | Array of available payment method objects for the specified account. | array |
| name | The unique name/identifier of the payment method. | string |
| status | The activation status of the payment method. | string |
| order | The display order for the payment method (lower number = higher priority). | integer |