# Pre Auth or Post Pay

**POST /gas-stations/{gasStationId}/transactions**

This call supports two different flows. The *Pre Auth* flow and the *Post Pay* flow. This call will notify the user via email with a payment receipt if transaction is finished successfully. Only use after approaching, otherwise returns `403 Forbidden`.
### Pre Auth
This flow is used if a pump is having the status `locked`. A `locked` pump requires a *Pre Auth* to unlock. Only after this *Pre Auth* the pump and can be used by the user
* `carFuelType` may be passed to only unlock a certain nozzle of the pump.
  Not all pumps support this feature, and some require it. It is advised to
  always pass the desired fuel type.

### Post Pay
You can optionally provide:
* `priceIncludingVAT` and `currency` in the request body to check if the price the user has seen is still correct.
  If the values don't match, the status `409 Conflict` is returned.
* `carFuelType` may be provided but has no effect.



## Servers
- Production server (stable release 2020-4): https://api.pace.cloud/fueling/2020-4 (Production server (stable release 2020-4))


## Authentication methods
- OAuth2
- Oidc


## Parameters

#### Path parameters
- **gasStationId** (string(uuid))
  Gas station ID


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

- **data** (object)
  

## Responses
### 201: Post Pay: Payment successful

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

### 202: Pre Auth: Pump unlocked
#### Headers
- **Location** (string(url))
  Location of the future payment transaction details

### 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])
  

### 403: Forbidden

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

### 404: Resource not found

#### 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: The provided priceIncludingVAT does not match the actual price

#### 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.

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

### 500: Internal server error

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

### 502: Error occurred while communicating with PACE services

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


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