HTM/ovpay
4
0
Fork 0
Code Issues Pull Requests 3 Actions Packages Projects Releases 1 Wiki Activity

Merge branch 'develop' into features/OVPAY2294-vouchers-in-orders

Browse Source
This commit is contained in:
Max Martens 2026-03-25 17:34:12 +01:00
commit 38094e7b29
2 changed files with 338 additions and 89 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

399
src/openapi/customers/customers-trips.yaml
View File

@ -11,7 +11,7 @@ paths:
get:
tags:
- Trips
summary: Get trips for a token
summary: Get trips for a token in profile
description: >-
Get the most recent trips for a given token ID, as long as this token is
bound to the profile (as derived from sub in given JWT)
@ -246,6 +246,298 @@ paths:
- default: []
x-auth-type: Application & Application User
x-throttling-tier: Unlimited
/customers/tokens/trips:
get:
tags:
- Trips
summary: Get trips for an anonymous token
description: >-
Get the most recent trips for a given token type and value (i.e. SRID and amount or OVpasnumber).
parameters:
- name: X-HTM-JWT-AUTH-HEADER
in: header
required: true
style: simple
explode: false
schema:
type: string
- name: tokenType
in: query
required: true
description: >-
A tokenType IS AN enumerated identifier THAT describes the type of
Token that will be used as an input for the translation.
schema:
type: string
enum:
- srfid
- passnumber
- name: tokenValue
in: query
required: true
description: >-
A tokenValue IS A string THAT defines the value of the specified
tokenType.
examples:
srfid:
value: P485Q6M797J9LW
summary: srfid
passnumber:
value: 424HJGF
summary: passNumber
schema:
type: string
- name: validatorType
in: query
required: true
description: >-
A validatorType IS A string THAT defines the type of the attribute
that is needed to verify the authenticity of the request.
Options:
- **verificationCode**: A validator containing, 4 characters long,
which can be found on a CLT-card
- **amount**: Amount on the bank statement (in cents)
example: verificationcode
schema:
type: string
enum:
- verificationcode
- amount
- name: validatorInput
in: query
required: true
description: >-
A validatorInput IS A string THAT defines the value of the specified
validatorType.
examples:
verificationcode:
value: 6RS9
summary: verificationcode
amount:
value: '1021'
summary: amount
schema:
type: string
- name: dateTimeFrom
in: query
required: false
style: form
explode: false
schema:
type: string
- name: dateTimeUntil
in: query
required: false
style: form
explode: false
schema:
type: string
- name: organisationId
in: query
required: false
style: form
explode: false
schema:
type: string
- name: transportType
in: query
required: false
style: form
explode: false
schema:
type: string
- name: lineId
in: query
required: false
style: form
explode: false
schema:
type: string
- name: paymentMethod
in: query
required: false
style: form
explode: false
schema:
type: string
- name: productTemplateId
in: query
required: false
style: form
explode: false
schema:
type: string
- name: category
in: query
required: false
style: form
explode: false
schema:
type: string
- name: tripStatus
in: query
required: false
style: form
explode: false
schema:
type: string
- name: tripId
in: query
required: false
style: form
explode: false
schema:
type: string
- name: showSuperseedingTrips
in: query
required: false
style: form
explode: false
schema:
type: string
- name: organisationName
in: query
required: false
style: form
explode: false
schema:
type: string
- name: limit
in: query
required: false
style: form
explode: false
schema:
type: integer
- name: offset
in: query
required: false
style: form
explode: false
schema:
type: integer
responses:
'200':
description: ok
content:
application/json:
schema:
$ref: '#/components/schemas/getTokenTrips'
examples:
emptyResponse:
summary: No trips found for a token
value: []
multipleTripsResponse:
summary: Multiple trips found for a token
value:
- tripId: 66538
tripVersion: 2
transportType: RAIL
lineId: "10"
tripStatus: COMPLETE
fare: 2470
currency: EUR
lastUpdatedTripDateTime: 2021-06-01T06:22:00Z
checkinTransactionTimestamp: 2021-06-01T06:00:00Z
checkoutTransactionTimestamp: 2021-06-01T06:22:00Z
checkinLocation:
stopId: 621
stopName:
items:
- key: nl-NL
value: Utrecht Centraal
- key: en-US
value: Utrecht Centraal
stopDesc: Station Utrecht Centraal
stopUrl: /icons/stops/stop.svg
locationType: 0
checkoutLocation:
stopId: 253
stopName:
items:
- key: nl-NL
value: Goes
- key: en-US
value: Goes
stopDesc: Station Goes
stopUrl: /icons/stops/stop.svg
locationType: 0
loyaltyOrDiscount: false
_links:
tripDetails:
href: https://services.acc.api.htm.nl/abt/abtcustomers/1.0/customers/tokens/123/trips/66538
method: GET
templated: false
- tripId: 66539
tripVersion: 1
transportType: BUS
lineId: "20"
tripStatus: MISSING_CKO
fare: 1230
currency: EUR
lastUpdatedTripDateTime: 2021-06-01T07:00:00Z
checkinTransactionTimestamp: 2021-06-01T06:30:00Z
checkoutTransactionTimestamp: null
checkinLocation:
stopId: 622
stopName:
items:
- key: nl-NL
value: Amsterdam Centraal
- key: en-US
value: Amsterdam Centraal
stopDesc: Station Amsterdam Centraal
stopUrl: /icons/stops/stop.svg
locationType: 0
checkoutLocation: null
loyaltyOrDiscount: true
_links:
getTripDetails:
href: https://services.acc.api.htm.nl/abt/abtcustomers/1.0/customers/tokens/123/trips/66539
method: GET
templated: false
getStopsForCorrection:
href: https://services.acc.api.htm.nl/abt/abtcustomers/1.0/customers/trips/stops?xbot=36637b86-7a31-4b77-99dd-2d39b9c1a9b6&tripId=66539&transactionId=001e8481-1151-gemaltoPure-1622527200000
method: GET
templated: false
'400':
description: '400'
content:
application/json:
schema:
$ref: '#/components/schemas/400Response'
'401':
description: '401'
content:
application/json:
schema:
$ref: '#/components/schemas/401Response'
'403':
description: '403'
content:
application/json:
schema:
$ref: '#/components/schemas/403Response'
'404':
description: '404'
content:
application/json:
schema:
$ref: '#/components/schemas/404Response'
'500':
description: '500'
content:
application/json:
schema:
$ref: '#/components/schemas/500Response'
security:
- default: []
x-auth-type: Application & Application User
x-throttling-tier: Unlimited
/customers/trips/{tripId}:
get:
tags:
@ -709,92 +1001,65 @@ paths:
summary: Possible stops for a trip with missing check-out
value:
xbot: 36637b86-7a31-4b77-99dd-2d39b9c1a9b6
counterpartTransactionId: 001e8481-1151-gemaltoPure-1622527200000
counterpartTransactionId: 003D08FF-75032799-emv-1773668001000
counterpartEntryExitType: ENTRY
counterpartTimeStamp: "2021-06-01T06:00:00Z"
counterpartTimeStamp: 2026-03-16T14:33:21+01:00
counterpartStop:
alternativeTexts:
- text:
lang: nl-NL
textIdType: Utrecht Centraal
text: Utrecht Centraal
name: Utrecht Centraal
shortName: Utrecht Centraal
description: Station Utrecht Centraal
location:
longitude: 5.1099
latitude: 52.0894
altitude: 0
stopId: 621
transportModes:
- BUS
- RAIL
deviceId: 3212967
deviceClassId: 9
textIdType: publicName
text: Delftsewallen
- text:
lang: en-US
textIdType: publicName
text: Delftsewallen
name: Stop point8124
description: Stop point8124
stopId: 8124
transportModes: []
deviceId: 3999999
deviceClassId: 0
scheduledStopPoints:
- alternativeTexts:
- text:
lang: nl-NL
textIdType: publicName
text: Brouwersgracht
name: Brouwersgracht
shortName: Brouwersgracht
description: Brouwersgracht
location:
longitude: 4.3050492
latitude: 52.0737538
altitude: 0
stopId: 42
transportModes:
- RAIL
text: Centrum-West
- text:
lang: en-US
textIdType: publicName
text: Centrum-West
name: Stop point8127
description: Stop point8127
stopId: 8127
transportModes: []
- alternativeTexts:
- text:
lang: nl-NL
textIdType: publicName
text: Grote Markt
name: Grote Markt
shortName: Grote Markt
description: Grote Markt
location:
longitude: 4.3092398
latitude: 52.075929
altitude: 0
stopId: 42
transportModes:
- RAIL
- BUS
text: Halte Onbekend
- text:
lang: en-US
textIdType: publicName
text: Halte Onbekend
name: Stop point65533
description: Stop point65533
stopId: 65533
transportModes: []
- alternativeTexts:
- text:
lang: nl-NL
textIdType: publicName
text: Spui
name: Spui
shortName: Spui
description: Spui
location:
longitude: 4.3172
latitude: 52.0764
altitude: 0
stopId: 42
transportModes:
- RAIL
- BUS
- alternativeTexts:
text: Dorp
- text:
lang: nl-NL
lang: en-US
textIdType: publicName
text: Den Haag Centraal
name: Den Haag Centraal
shortName: Den Haag Centraal
description: Den Haag Centraal
location:
longitude: 4.32553
latitude: 52.08176
altitude: 0
stopId: 42
transportModes:
- RAIL
- BUS
text: Dorp
name: Stop point8126
description: Stop point8126
stopId: 8126
transportModes: []
'400':
description: '400'
content:

20
src/openapi/products/SE-vouchers-TP.yaml
View File

@ -10,25 +10,9 @@ paths:
get:
summary: Get a list of issued vouchers that were issued for a specific touch point
description:
Retrieve all issued vouchers for a specific touch point. This means that only products that have active sellingPeriods for touch points within the same
retailer as the calling touch point are returned.
Retrieve all issued vouchers for a specific touch point. This means that only products that the calling touch point is allowed to see or sell
(i.e. has active sellingPeriods for touchPointId of the calling touch point) are returned.
parameters:
- name: touchpointId
in: query
required: false
description: |
This endpoint is meant for salesTouchpoints to check the existance and validity of the voucher a customer has supplied
schema:
type: integer
example: 1001
- name: issuedVoucherId
in: query
required: false
description: The unique identifier of the issued voucher instance to retrieve.
schema:
type: string
format: uuid
example: d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90
- name: voucherCode
in: query
required: false