createPaymentUsingPOST

post

createPaymentUsingPOST

Payment initiation request for single and periodic payments

Resource URL

https://xs2a-api.comdirect.de /berlingroup/v1/{payment-service}/{payment-product}

Header Parameters


Name Description
TPP-Redirect-URI
(required)

URI of the TPP, where the user shall be redirected after consent authorization

TPP-Nok-Redirect-URI

If this URI is contained, the TPP is asking to redirect the transaction flow to this address instead of the TPP-Redirect-URI in case of a negative result of the redirect SCA method. This might be ignored by the ASPSP.

PSU-ID

Client ID of the PSU in the ASPSP client interface.

PSU-ID-TYPE

Type of the PSU-ID; needed in scenarios where PSUs have several PSU-IDs as access possibility.

TPP-Redirect-Preferred

Specifies whether a redirect workflow is preferred for user consent signing. Specifies the TPP's preference for the authorization protocol to be used, however the final decision is made by the ASPSP.

X-Request-ID
(required)

ID of the request, unique to the call, as determined by the initiating party.

PSU-IP-Address
(required)

The forwarded IP Address header field consists of the corresponding HTTP request IP Address field between PSU and TPP.

TPP-Explicit-Authorisation-Preferred

TPP prefers to start the authorisation process separately or no

PSU-Accept-Language

The forwarded accept language header field consist of the corresponding HTTP request accept header between PSU and TPP, if available. Expected format is LanguageTag-CountryTag where:
- LanguageTag is any two-letters matching an ISO-639 language abbreviation
- CountryTag is any two-letters matching an ISO-3166 country code and is optional

Authorization

Combined service AIS Access token.

Consent-ID

This data element may be contained, if the payment initiation transaction is part of a session, i.e. combined AIS/PIS service. This then contains the consentId of the related AIS consent, which was performed prior to this payment initiation.

Body Parameters


Name Description
paymentRequest
(required)

Request Body

Payload containing the data to initiate the payment

payment-service The payment service null true

payment-product The addressed payment product endpoint null true

HTTP Basic

OAuth 2.0

API Key

Response Error Details

  • HTTP Code
    Error Code
    Description
  • 400
    400

    Missing or erroneous parameter Bad Request

  • 401
    401

    Unauthorized : Incorrect certificate Unauthorized : Missing Certificate

  • 404
    404

    Unknown payment service Unknown payment product

  • 500
    500

    Internal Server Error

Resource Summary

Security

Content Type

application/json;charset=UTF-8

Category

BerlinGroup PIS

Working...