# Register a Zieglmeier Card as a payment method

**POST /payment-methods/zgm**

By registering you allow the user to use a Zieglmeier Card as a payment method.
The payment method ID is optional when posting data.



## Servers
- Production server (stable release 2025-1): https://api.pace.cloud/pay/2025-1 (Production server (stable release 2025-1))


## Authentication methods
- O auth2
- Oidc


## Parameters



## Body parameters
Content-type: application/vnd.api+json

- **data** (object)
  

## Responses
### 201: Created

#### Body Parameters: application/vnd.api+json (object)
- **data** (object)
  

### 303: Already exists
#### Headers
- **Location** (string(url))
  Location of the already existing payment method

### 400: Bad request

#### Body Parameters: application/vnd.api+json (object)
- **errors** (array[object])
  

### 401: OAuth token missing or invalid or a linked identity is missing.

Linked identity missing is a special case where you need to make sure that
the user has additionally logged in / authorized with a third-party.

This is not relevant for most use-cases.

The specific error code that identifies a missing linked identity is `missing-linked-identity`

Example:

```
  {
      "errors": [
          {
              "id": "cbgmhslmp1o9or9kh1p0",
              "title": "Missing linked identity for authorized access",
              "detail": "Linked identity is needed to access this resource, please check why the user does not have a linked identity",
              "status": "401",
              "code": "missing-linked-identity"
          }
      ]
  }
```


#### Body Parameters: application/vnd.api+json (object)
- **errors** (array[object])
  

### 406: The specified accept header is invalid

#### Body Parameters: application/vnd.api+json (object)
- **errors** (array[object])
  

### 409: Resource conflicts

#### Body Parameters: application/vnd.api+json (object)
- **errors** (array[object])
  

### 415: The specified content type header is invalid

#### Body Parameters: application/vnd.api+json (object)
- **errors** (array[object])
  

### 422: The request was well-formed but was unable to be followed due to semantic errors. The following codes may be seen:
* `provider:card-not-usable`: The card is rejected by the payment provider, e.g., fuelcard deactivated
* `provider:invalid-content`: One or more fields of the payment method is not accepted by the payment provider.
* `invalid-charset`: The fields charset is not latin
* `too-long`: The fields content is too long


#### Body Parameters: application/vnd.api+json (object)
- **errors** (array[object])
  

### 500: Internal server error

#### Body Parameters: application/vnd.api+json (object)
- **errors** (array[object])
  


[Powered by Bump.sh](https://bump.sh)