HiPay Maintenance API
Perform operations (capture, refund) on transactions
Operations 1
POST
/v1/maintenance/transaction/{transaction_reference}
Performs a maintenance operation on a given transaction
#
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/hipay:hipay-maintenance-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: HiPay Enterprise Gateway Maintenance API
description: The Gateway API allows you to get paid and manage orders and transactions.
contact:
email: pi-commerce@hipay.com
version: 1.2.3
servers:
- url: https://stage-secure-gateway.hipay-tpp.com/rest
description: Stage
- url: https://secure-gateway.hipay-tpp.com/rest
description: Production
tags:
- name: Maintenance
description: Perform operations (capture, refund) on transactions
paths:
/v1/maintenance/transaction/{transaction_reference}:
post:
tags:
- Maintenance
summary: Performs a maintenance operation on a given transaction
description: Performs a maintenance operation on a given transaction.
operationId: performMaintenanceOperation
parameters:
- name: transaction_reference
in: path
description: The unique identifier of the transaction.
required: true
schema:
type: string
example: '800000420435'
x-sort: 1
requestBody:
description: Maintenance information
required: true
content:
multipart/form-data:
schema:
$ref: '#/components/schemas/Maintenance'
responses:
'200':
description: The maintenance operation was executed successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/Operation'
'400':
description: The request was rejected due to a validation error.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: An authentication error occurred/invalid credentials.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Access to this resource is fordidden.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Transaction was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
security:
- basicAuth: []
components:
schemas:
Error:
title: Error
description: Error model
properties:
code:
description: Code
type: integer
x-sort: 1
message:
description: Message
type: string
x-sort: 5
description:
description: Description
type: string
x-sort: 10
type: object
Operation:
title: Operation
description: Operation model
properties:
operation:
description: The operation to perform on the transaction.
type: string
enum:
- capture
- refund
- cancel
- acceptChallenge
- denyChallenge
example: capture
x-sort: 1
mid:
description: ''
type: string
example: 00001326589
x-sort: 5
authorizationCode:
description: ''
type: string
example: author
x-sort: 10
transactionReference:
description: ''
type: string
example: '800000968431'
x-sort: 15
status:
description: ''
type: string
example: '118'
x-sort: 35
message:
description: ''
type: string
example: Captured
x-sort: 40
dateCreated:
description: ''
type: string
example: 2019-02-07T10:07:09+0000
x-sort: 20
dateUpdated:
description: ''
type: string
example: 2019-02-07T10:07:09+0000
x-sort: 25
dateAuthorized:
description: ''
type: string
example: 2019-02-07T10:07:09+0000
x-sort: 30
authorizedAmount:
description: ''
type: string
example: '125.85'
x-sort: 45
capturedAmount:
description: ''
type: string
example: '125.85'
x-sort: 50
refundedAmount:
description: ''
type: string
example: '0.00'
x-sort: 55
decimals:
description: ''
type: string
example: '2'
x-sort: 60
currency:
description: ''
type: string
example: EUR
x-sort: 65
type: object
Maintenance:
title: Maintenance
description: Maintenance model
required:
- operation
properties:
operation:
description: "The operation to perform on the transaction.\n\n The payment gateway supports the following types of maintenance transactions.\n\n | Operation Type | Description |\n | -------------- | ----------- |\n | `capture` | A request instructing the payment gateway to capture a previously-authorized transaction, i.e. transfer the funds from the customer’s bank account to the merchant’s bank account. This transaction is always preceded by an authorization. |\n | `refund` | A request instructing the payment gateway to refund a previously captured transaction. A captured transaction can be partly or fully refunded. |\n | `cancel` | A request instructing the payment gateway to cancel a previously authorized transaction. Only authorized transactions can be cancelled, captured transactions must be refunded. |\n | `acceptChallenge` | A request instructing the payment gateway to accept a previously challenged transaction. |\n | `denyChallenge` | A request instructing the payment gateway to deny a previously challenged transaction. |\n | `finalize` | A request instructing the payment gateway to finalize an asynchronous operation. |"
type: string
enum:
- capture
- refund
- cancel
- acceptChallenge
- denyChallenge
- finalize
example: capture
x-sort: 1
currency:
description: Base currency for this order. This three-character currency code complies with ISO 4217.
type: string
enum:
- FRF
- SKK
- EEK
- TMT
- AED
- AFN
- ALL
- AMD
- ANG
- AOA
- ARS
- AUD
- AWG
- AZN
- BAM
- BBD
- BDT
- BGN
- BHD
- BIF
- BMD
- BND
- BOB
- BRL
- BSD
- BTN
- BWP
- BYR
- BZD
- CAD
- CDF
- CHF
- CLP
- CNY
- COP
- CRC
- CUC
- CUP
- CVE
- CZK
- DJF
- DKK
- DOP
- DZD
- EGP
- ERN
- ETB
- EUR
- FJD
- FKP
- GBP
- GEL
- GHS
- GIP
- GMD
- GNF
- GTQ
- GYD
- HKD
- HNL
- HRK
- HTG
- HUF
- IDR
- ILS
- INR
- IQD
- IRR
- ISK
- JMD
- JOD
- JPY
- KES
- KGS
- KHR
- KMF
- KPW
- KRW
- KWD
- KYD
- KZT
- LAK
- LBP
- LKR
- LRD
- LSL
- LTL
- LVL
- LYD
- MAD
- MDL
- MGA
- MKD
- MMK
- MNT
- MOP
- MRO
- MUR
- MVR
- MWK
- MXN
- MYR
- MZN
- NAD
- NGN
- NIO
- NOK
- NPR
- NZD
- OMR
- PAB
- PEN
- PGK
- PHP
- PKR
- PLN
- PYG
- QAR
- RON
- RSD
- RUB
- RWF
- SAR
- SBD
- SCR
- SDG
- SEK
- SGD
- SHP
- SLL
- SOS
- SRD
- STD
- SVC
- SYP
- SZL
- THB
- TJS
- TND
- TOP
- TRY
- TTD
- TWD
- TZS
- UAH
- UGX
- USD
- UYU
- UZS
- VEF
- VND
- VUV
- TMM
- WST
- XAF
- XCD
- XOF
- XPF
- YER
- ZAR
- ZMK
- ZWL
example: EUR
additionalProperties:
default: EUR
x-sort: 5
amount:
description: Amount is required for partial maintenances. Do not specify amount for full captures or refunds.
type: string
example: '3.5'
x-sort: 10
operation_id:
description: Operation merchant ID. This value will be returned to merchant with the notifications related to this operation.
type: string
example: 204OJ23LKJ234
x-sort: 15
basket:
description: "Shopping cart details. **You must send only items that must be captured or refunded.**\n\n Please refer to [HiPay Enterprise - Payment Gateway - Shopping cart managment](https://support.hipay.com/hc/fr/articles/115001660469-Payment-Gateway-Shopping-cart-management) technical documentation."
type: string
x-sort: 20
sub_transaction_reference:
description: Number of the subtransaction to be refunded.
type: string
example: '134470136955'
x-sort: 25
source:
description: "To identify the origin of the transaction. Here are the authorized values for source property:\n\n `AUTO`, `SAPI`, `CONS`, `PAGE`, `TPE`, `RTRY`, `MANU`, `PREF`, `REVI`, `CMS`, `SSDK`, `CSDK`"
type: string
example: '{"integration_version":"1.9.0","brand":"DEVPORTAL","source":"CSDK","brand_version":"12.2.0"}'
x-sort: 30
type: object
securitySchemes:
basicAuth:
type: http
scheme: basic
apiKey:
type: apiKey
name: X-Api-Key
in: header
externalDocs:
description: Find out more about HiPay
url: https://developer.hipay.com/