createPaymentUsingPOST

Set Admin Credentials...
createPaymentUsingPOST

post

createPaymentUsingPOST

Payment initiation request for single and periodic payments

Resource URL

https://psd2.api.commerzbank.com/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.

Request Body

Payload containing the data to initiate the payment 
{
1
{
2
    "creditorAccount": {
3
        "bban": "",
4
        "currency": "",
5
        "iban": "",
6
        "maskedPan": "",
7
        "msisdn": ""
8
    },
9
    "creditorAddress": {
10
        "buildingNumber": "",
11
        "townName": "",
12
        "country": "",
13
        "postCode": "",
14
        "streetName": ""
15
    },
16
    "creditorAgent": "",
17
    "creditorName": "",
18
    "dayOfExecution": "",
19
    "debtorAccount": {
20
        "bban": "",
21
        "currency": "",
22
        "iban": "",
23
        "maskedPan": "",
24
        "msisdn": ""
25
    },
26
    "endDate": "",
27
    "endToEndIdentification": "",
28
    "instructionIdentification": "",
29
    "executionRule": "",
30
    "frequency": "",
31
    "instructedAmount": {
32
        "amount": 0,
33
        "currency": ""
34
    },
35
    "remittanceInformationUnstructured": "",
36
    "requestedExecutionDate": "",
37
    "startDate": "",
38
    "debtorId": "",
39
    "debtorName": "",
40
    "ultimateDebtor": "",
41
    "currencyOfTransfer": "",
42
    "exchangeRateInformation": "",
43
    "creditorAgentName": "",
44
    "creditorId": "",
45
    "creditorNameAndAddress": "",
46
    "ultimateCreditor": "",
47
    "purposeCode": "",
48
    "chargeBearer": "",
49
    "remittanceInformationUnstructuredArray": "",
50
    "remittanceInformationStructured": "",
51
    "remittanceInformationStructuredArray": "",
52
    "serviceLevel": "",
53
    "requestedExecutionTime": ""
54
}
 

payment-service The payment service null true

payment-product The addressed payment product endpoint null true

HTTP Basic

Set...

OAuth 2.0

Set...

API Key

Set...

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

None

Content Type

application/json;charset=UTF-8

Category

BerlinGroup PIS

Working...