# DN Payment Initiation API

**Canonical:** https://apis.io/apis/diebold/dn-payment-initiation-api/  
**Provider:** Diebold Nixdorf — https://apis.io/providers/diebold/  
**Base URL:** https://{customer-host}:8080/pi-api/v1  
**Documentation:** https://api.swaggerhub.com/apis/Diebold-Nixdorf/dn_payment_initiation_api/1.9.11

DN Payment Initiation API is one of 8 APIs that [Diebold Nixdorf](https://apis.io/providers/diebold/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Banking, Payments, ATM, Self-Service, and Transaction Middleware. The published artifact set on APIs.io includes an OpenAPI specification and an API reference.

Public Payment Initiation API (PI-API) of Diebold Nixdorf providing access to the Vynamic Transaction Middleware for initiating payments. Declares an OpenID Connect scheme against a Microsoft Entra ID tenant. 11 paths; OpenAPI 3.0.1, version 1.9.11.

## Operations (16)

| Method | Path | Summary |
|---|---|---|
| POST | `/pay/{merchantId}/initiateSession` | Initiate a payment session for token based payments like Google Pay or Apple Pay. |
| POST | `/pay/{merchantId}/creditBalance` | The creditBalance API call returns the credit balance of a payer in case of success. |
| POST | `/pay/{merchantId}/authorize` | Authorizes a later cardless payment transaction. |
| POST | `/pay/{merchantId}/cardless` | Initiate a cardless payment transaction. |
| POST | `/pay/{merchantId}/cardbased/{cardBasedTransactionType}` | Initiate a card based payment transaction. |
| PUT | `/pay/{merchantId}/confirm/{transactionId}` | Confirm a payment transaction |
| GET | `/{merchantId}/payments` | Retrive a set of payment transactions. |
| DELETE | `/payments/{merchantId}/{transactionId}` | Cancel a payment transaction. |
| PUT | `/payments/{merchantId}/{transactionId}` | Refund a payment transaction. |
| GET | `/payments/{merchantId}/{transactionId}` | Retrive the details and state of a certain payment transaction. |
| GET | `/pkiKey` | Retrive the public (RSA) key of the server system. |
| GET | `/{merchantId}/devices` | Get all devices of a certain merchant. |
| POST | `/device/{merchantId}/{terminalId}` | Create a payment device such as a POS terminal or a mobile device. |
| PUT | `/device/{merchantId}/{terminalId}` | Update a payment device such as a POS terminal or a mobile device. |
| GET | `/device/{merchantId}/{terminalId}` | Get device info of a payment device such as a POS terminal or a mobile device. |
| DELETE | `/device/{merchantId}/{terminalId}` | Delete a payment device such as a POS terminal or a mobile device. |

## Machine-readable artifacts (4)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/diebold/refs/heads/main/openapi/diebold-dn-payment-initiation-api-openapi.yml
- **APIReference** — https://api.swaggerhub.com/apis/Diebold-Nixdorf/dn_payment_initiation_api/1.9.11
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/diebold/refs/heads/main/overlays/diebold-dn-payment-initiation-api-overlay.yaml
- **DeclineCodes** — https://raw.githubusercontent.com/api-evangelist/diebold/refs/heads/main/errors/diebold-decline-codes.yml

## Other Diebold Nixdorf APIs (7)

- [DN Open Backend API](https://apis.io/apis/diebold/dn-open-backend-api/)
- [DN Online & Mobile API](https://apis.io/apis/diebold/dn-online-mobile-api/)
- [DN Assist API](https://apis.io/apis/diebold/dn-assist-api/)
- [DN TM Authorization API](https://apis.io/apis/diebold/dn-tm-authorization-api/)
- [DN Account BC API](https://apis.io/apis/diebold/dn-account-bc-api/)
- [DN Secure Business Processing API](https://apis.io/apis/diebold/dn-secure-business-processing-api/)
- [TM Pre-Digitization API (Outbound)](https://apis.io/apis/diebold/tm-pre-digitization-api-outbound/)

## Tags

Banking, Payments, ATM, Self-Service, Transaction Middleware, Vynamic, Payment Initiation, Open Banking, OpenID Connect

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/diebold/dn-payment-initiation-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/diebold/.