Bulk Payments Initiation 3.1.5

0
No votes yet

The Payment Initiation API enables you to initiate a payment using one of the payment products made available by the Bank of the Payment Service User in his internet Banking.

With this API it is possible to integrate this type of of payments in an online store as well as to provide personal finance services to both private and corporate clients.

This API intends to provide an interface to access PSD2 Payments services.

The API is designed on a REST model using JSON structures.

production
development
https://site1.sibsapimarket.com:8445/sibs/apimarket-sb
production
development
https://site2.sibsapimarket.com:8445/sibs/apimarket-sb

Paths

/{aspsp-cde}/v1-0-3/bulk-payments/{payment-product}

post /{aspsp-cde}/v1-0-3/bulk-payments/{payment-product}
Bulk Payment Initiation Request

Bulk Payment Initiation Request

Creates a bulk payment initiation request at the ASPSP.

x-ibm-client-id
X-IBM-Client-Id
(apiKey located in header)
aspsp-cde
Required in path
string

Identification of the aspsp

{
    "default": ""
}
payment-product
Required in path
string

Type of payment

{
    "default": "sepa-credit-transfers",
    "enum": [
        "sepa-credit-transfers",
        "cross-border-credit-transfers",
        "instant-sepa-credit-transfers",
        "target-2-payments",
        "sdcl-sepa-credit-transfers",
        "urgent-sepa-credit-transfers"
    ]
}
tppRedirectPreferred
Optional in query
boolean

If it equals “true”, the TPP prefers a redirect over an embedded SCA approach. If it equals “false”, the TPP prefers not to be redirected for SCA. The ASPSP will then choose between the Embedded or the Decoupled SCA approach, depending on the choice of the SCA procedure by the TPP/PSU. If the parameter is not used, the ASPSP will choose the SCA approach to be applied depending on the SCA method chosen by the TPP/PSU.

{
    "default": false
}
TPP-Transaction-ID
Required in header
string / uuid

ID of the transaction as determined by the initiating party.

{
    "default": ""
}
TPP-Request-ID
Required in header
string / uuid

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

{
    "default": ""
}
PSU-ID
Optional in header
string

User identification in ASPSP

{
    "default": ""
}
PSU-ID-Type
Optional in header
string

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

{
    "default": ""
}
PSU-Corporate-ID
Optional in header
string

Corporate User identification in ASPSP

{
    "default": ""
}
PSU-Corporate-ID-Type
Optional in header
string

Might be mandated in the ASPSPs documentation. Only used in a corporate context.

{
    "default": ""
}
PSU-Consent-ID
Optional in header
string

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.

{
    "default": ""
}
PSU-Agent
Optional in header
string

The forwarded Agent header field of the http request between PSU and TPP.

{
    "default": ""
}
PSU-IP-Address
Required in header
string

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

{
    "default": ""
}
PSU-IP-Port
Optional in header
string

The forwarded IP Port header field consists of the corresponding HTTP request IP Port field between PSU and TPP, if available.

{
    "default": ""
}
PSU-Device-ID
Optional in header
string

UUID (Universally Unique Identifier) for a device, which is used by the PSU, if available. UUID identifies either a device or a device dependant application installation. In case of an installation identification this ID need to be unaltered until removal from device.

{
    "default": ""
}
PSU-Device-Fingerprint
Optional in header
string

Fingerprint of the device used in the request between PSU and TPP, if available.

{
    "default": ""
}
Transaction-SCA-Performed
Optional in header
string

Only used for Delegated Authentication Approach. \n "NSCA" - "SCA Not performed"; \n "SUCC" - "SCA Performed with Success"; \n If this data element is not used, there is no information about transaction SCA authentication

{
    "enum": [
        "NSCA",
        "SUCC"
    ]
}
PSU-Geo-Location
Optional in header
string

The forwarded Geo Location of the corresponding http request between PSU and TPP if available.

{
    "pattern": "^GEO:[-?+?(\\d){1,3}.(\\d){6}]{8,11};[-?+?(\\d){1,3}.(\\d){6}]{8,11}$",
    "default": "GEO:1.111111;-1.111111"
}
TPP-Redirect-URI
Optional in header
string

URI of the TPP, where the transaction flow shall be redirected to after a Redirect. Shall be contained at least if the tppRedirectPreferred parameter is set to true or is missing.

{
    "default": ""
}
TPP-Delegated-Preferred
Optional in header
boolean

If it equals “true”, the TPP requests a delegated SCA approach. If it equals “false”, the TPP do not request a delegated SCA approach. If the parameter is not used, the TPP do not request a delegated SCA approach.

Delegation-ID
Optional in header
string

An identification provided by the ASPSP for the later identification of the authentication delegated.

Signature
Required in header
string

A signature of the request by the TPP on application level. This might be mandated by ASPSP.

{
    "default": ""
}
TPP-Certificate
Required in header
string

The certificate used for signing the request, in base64 encoding. Shall be contained if the signature is used.

{
    "default": ""
}
Date
Required in header
string / date-time

Request date

{
    "pattern": "yyyy-MM-dd'T'hh:MM:ss.SSS"
}
Digest
Optional in header
string

Hash of the message body. Should be present when Request body exists

{
    "default": ""
}
BulkPaymentRequest
Required in body
object

Bulk Payment Initiation Request

{
    "schema": {
        "description": "Creates a bulk payment initiation request at the ASPSP.",
        "type": "object",
        "properties": {
            "debtorAccount": {
                "$ref": "#\/definitions\/AccountReference",
                "description": ""
            },
            "debtorName": {
                "description": "Payment's debtor name.",
                "maxLength": 70,
                "type": "string"
            },
            "batchBookingPreferred": {
                "type": "boolean",
                "description": "If this element equals true, the PSU prefers only one booking entry. If this element equals false, the PSU prefers individual booking of all contained individual transactions. The ASPSP will follow this preference according to contracts agreed on with the PSU."
            },
            "paymentInformationId": {
                "description": "Unique identification as assigned by the sending party to unambiguously identify this bulk payment.",
                "maxLength": 35,
                "minLength": 1,
                "type": "string"
            },
            "requestedExecutionDate": {
                "type": "string",
                "format": "date",
                "description": "Indicates the acceptance of future dated payments by issuing an ASPSP."
            },
            "payments": {
                "description": "Array of Payment Initiations",
                "$ref": "#\/definitions\/BulkEntryArray"
            }
        },
        "additionalProperties": false,
        "required": [
            "payments",
            "paymentInformationId"
        ]
    }
}
Content-Type
Optional in header
string
application/json
Accept
Optional in header
string
application/json
201

Created

BulkPaymentResponseResource
400

Bad Request.

ErrorMessageWithStatus
401

Unauthorized.

ErrorMessageWithStatus
403

Forbidden.

ErrorMessageWithStatus
404

Not Found.

ErrorMessageWithStatus
405

Method Not Allowed.

ErrorMessageWithStatus
406

Not Acceptable.

ErrorMessageWithStatus
408

Request Timeout.

ErrorMessageWithStatus
415

Unsupported Media Type.

ErrorMessageWithStatus
429

Too Many Requests.

ErrorMessageWithStatus
500

Internal Server Error.

ErrorMessageWithStatus
503

Service Unavailable.

ErrorMessageWithStatus
504

Gatewaty Timeout.

ErrorMessageWithStatus
Example Request
curl --request POST \
  --url 'https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers?tppRedirectPreferred=REPLACE_THIS_VALUE' \
  --header 'Date: REPLACE_THIS_VALUE' \
  --header 'Delegation-ID: REPLACE_THIS_VALUE' \
  --header 'Digest: REPLACE_THIS_VALUE' \
  --header 'PSU-Agent: REPLACE_THIS_VALUE' \
  --header 'PSU-Consent-ID: REPLACE_THIS_VALUE' \
  --header 'PSU-Corporate-ID: REPLACE_THIS_VALUE' \
  --header 'PSU-Corporate-ID-Type: REPLACE_THIS_VALUE' \
  --header 'PSU-Device-Fingerprint: REPLACE_THIS_VALUE' \
  --header 'PSU-Device-ID: REPLACE_THIS_VALUE' \
  --header 'PSU-Geo-Location: GEO:1.111111;-1.111111' \
  --header 'PSU-ID: REPLACE_THIS_VALUE' \
  --header 'PSU-ID-Type: REPLACE_THIS_VALUE' \
  --header 'PSU-IP-Address: REPLACE_THIS_VALUE' \
  --header 'PSU-IP-Port: REPLACE_THIS_VALUE' \
  --header 'Signature: REPLACE_THIS_VALUE' \
  --header 'TPP-Certificate: REPLACE_THIS_VALUE' \
  --header 'TPP-Delegated-Preferred: REPLACE_THIS_VALUE' \
  --header 'TPP-Redirect-URI: REPLACE_THIS_VALUE' \
  --header 'TPP-Request-ID: REPLACE_THIS_VALUE' \
  --header 'TPP-Transaction-ID: REPLACE_THIS_VALUE' \
  --header 'Transaction-SCA-Performed: REPLACE_THIS_VALUE' \
  --header 'X-IBM-Client-Id: REPLACE_THIS_KEY' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{"debtorAccount":{"iban":"PT000","bban":"1","pan":"","maskedPan":"","msisdn":"","currency":"SXR"},"debtorName":"Lucas Sparks","batchBookingPreferred":false,"paymentInformationId":"3565709980336128","requestedExecutionDate":"2001-01-05","payments":[{"instructedAmount":{"currency":"EUR","content":"0"},"endToEndIdentification":"","creditorAccount":{"iban":"PT000","bban":"1","pan":"","maskedPan":"","msisdn":"","currency":"OWI"},"creditorAgent":"ABCDEFABC0A","creditorName":"a","creditorAddress":{"street":"","buildingNumber":"","city":"","postalCode":"","country":""},"creditorClearingCode":"4903448233539106"
Show more open_in_new
require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers?tppRedirectPreferred=REPLACE_THIS_VALUE")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Post.new(url)
request["X-IBM-Client-Id"] = 'REPLACE_THIS_KEY'
request["TPP-Transaction-ID"] = 'REPLACE_THIS_VALUE'
request["TPP-Request-ID"] = 'REPLACE_THIS_VALUE'
request["PSU-ID"] = 'REPLACE_THIS_VALUE'
request["PSU-ID-Type"] = 'REPLACE_THIS_VALUE'
request["PSU-Corporate-ID"] = 'REPLACE_THIS_VALUE'
request["PSU-Corporate-ID-Type"] = 'REPLACE_THIS_VALUE'
request["PSU-Consent-ID"] = 'REPLACE_THIS_VALUE'
request["PSU-Agent"] = 'REPLACE_THIS_VALUE'
request["PSU-IP-Address"] = 'REPLACE_THIS_VALUE'
request["PSU-IP-Port"] = 'REPLACE_THIS_VALUE'
request["PSU-Device-ID"] = 'REPLACE_THIS_VALUE'
request["PSU-Device-Fingerprint"] = 'REPLACE_THIS_VALUE'
request["Transaction-SCA-Performed"] = 'REPLACE_THIS_VALUE'
request["PSU-Geo-Location"] = 'GEO:1.111111;-1.111111'
request["TPP-Redirect-URI"] = 'REPLACE_THIS_VALUE'
request["TPP-Delegated-Preferred"] = 'REPLACE_THIS_VALUE'
request["Delegation-ID"] = 'REPLACE_THIS_VALUE'
request["Signature"] = 'REPLACE_THIS_VALUE'
request["TPP-Certificate"] = 'REPLACE_THIS_VALUE'
request["Date"] = 'REPLACE_THIS_VALUE'
request["Digest"] = 'REPLACE_THIS_VALUE'
request["content-type"] = 'application/json'
request["accept"] = 'application/json'
request.body = "{\"debtorAccount\":{\"iban\":\"PT000\",\"bban\":\"1\",\"pan\":\"\",\"maskedPan\":\"\",\"msisdn\":\"\",\"currency\":\"SXR\"},\"debtorName\":\"Lucas Sparks\",\"batchBookingPreferred\":false,\"paymentInformationId\":\"3565709980336128\",\"requestedExecutionDate\":\"2001-01-05\",\"payments\":[{\"instructedAmount\":{\"currency\":\"EUR\",\"content\":\"0\"},\"endToEndIdentification\":\"\",\"creditorAccount\":{\"iban\":\"PT000\",\"bban\":\"1\",\"pan\":\"\",
Show more open_in_new
import http.client

conn = http.client.HTTPSConnection("site1.sibsapimarket.com:8445")

payload = "{\"debtorAccount\":{\"iban\":\"PT000\",\"bban\":\"1\",\"pan\":\"\",\"maskedPan\":\"\",\"msisdn\":\"\",\"currency\":\"SXR\"},\"debtorName\":\"Lucas Sparks\",\"batchBookingPreferred\":false,\"paymentInformationId\":\"3565709980336128\",\"requestedExecutionDate\":\"2001-01-05\",\"payments\":[{\"instructedAmount\":{\"currency\":\"EUR\",\"content\":\"0\"},\"endToEndIdentification\":\"\",\"creditorAccount\":{\"iban\":\"PT000\",\"bban\":\"1\",\"pan\":\"\",\"maskedPan\":\"\",\"msisdn\":\"\",\"currency\":\"OWI\"},\"creditorAgent\":\"ABCDEFABC0A\",\"creditorName\":\"a\",\"creditorAddress\":{\"street\":\"\",\"buildingNumber\":\"\",\"city\":\"\",\"postalCode\":\"\",\"country\":\"\"},\"creditorClearingCode\":\"4903448233539106\",\"remittanceInformationUnstructured\":\"\",\"purposeCode\":\"icol\",\"chargeBearer\":\"SHAR\",\"creditorAgentName\":\"30074838931581\",\"creditorAgentAddress\":{\"street\":\"\",\"buildingNumber\":\"\",\"city\":\"\",\"postalCode\":\"\",\"country\":\"\"}},{\"instructedAmount\":{\"currency\":\"EUR\",\"content\":\"0\"},\"endToEndIdentification\":\"\",\"creditorAccount\":{\"iban\":\"PT000\",\"bban\":\"1\",\"pan\":\"\",\"maskedPan\":\"\",\"msisdn\":\"\",\"currency\":\"CKN\"},\"creditorAgent\":\"ABCDEFABC0A\",\"creditorName\":\"a\",\"creditorAddress\":{\"street\":\"\",\"buildingNumber\":\"\",\"city\":\"\",\"postalCode\":\"\",\"country\":\"\"},\"creditorClearingCode\":\"6304236509352134\",\"remittanceInformationUnstructured\":\"\",\"purposeCode\":\"dufo\",\"chargeBearer\":\"SHAR\",\"creditorAgentName\":\"5497962127109205\",\"creditorAgentAddress\":{\"street\":\"\",\"buildingNumber\":\"\",\"city\":\"\",\"postalCode\":\"\",\"country\":\"\"}},{\"instructedAmount\":{\"currency\":\"EUR\",\"content\":\"0\"},\"endToEndIdentification\":\"\",\"creditorAccount\":{\"iban\":\"PT000\",\"bban\":\"1\",\"pan\":\"\",\"maskedPan\":\"\",\"msisdn\":\"\",\"currency\":\"NML\"},\"credito
Show more open_in_new
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "8445",
  CURLOPT_URL => "https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers?tppRedirectPreferred=REPLACE_THIS_VALUE",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "{\"debtorAccount\":{\"iban\":\"PT000\",\"bban\":\"1\",\"pan\":\"\",\"maskedPan\":\"\",\"msisdn\":\"\",\"currency\":\"SXR\"},\"debtorName\":\"Lucas Sparks\",\"batchBookingPreferred\":false,\"paymentInformationId\":\"3565709980336128\",\"requestedExecutionDate\":\"2001-01-05\",\"payments\":[{\"instructedAmount\":{\"currency\":\"EUR\",\"content\":\"0\"},\"endToEndIdentification\":\"\",\"creditorAccount\":{\"iban\":\"PT000\",\"bban\":\"1\",\"pan\":\"\",\"maskedPan\":\"\",\"msisdn\":\"\",\"currency\":\"OWI\"},\"creditorAgent\":\"ABCDEFABC0A\",\"creditorName\":\"a\",\"creditorAddress\":{\"street\":\"\",\"buildingNumber\":\"\",\"city\":\"\",\"postalCode\":\"\",\"country\":\"\"},\"creditorClearingCode\":\"4903448233539106\",\"remittanceInformationUnstructured\":\"\",\"purposeCode\":\"icol\",\"chargeBearer\":\"SHAR\",\"creditorAgentName\":\"30074838931581\",\"creditorAgentAddress\":{\"street\":\"\",\"buildingNumber\":\"\",\"city\":\"\",\"postalCode\":\"\",\"country\":\"\"}},{\"instructedAmount\":{\"currency\":\"EUR\",\"content\":\"0\"},\"endToEndIdentification\":\"\",\"creditorAccount\":{\"iban\":\"PT000\",\"bban\":\"1\",\"pan\":\"\",\"maskedPan\":\"\",\"msisdn\":\"\",\"currency\":\"CKN\"},\"creditorAgent\":\"ABCDEFABC0A\",\"creditorName\":\"a\",\"creditorAddress\":{\"street\":\"\",\"buildingNumber\":\"\",\"city\":\"\",\"postalCode\":\"\",\"country\":\"\"},\"creditorClearingCode\":\"6304236509352134\",\"remittanceInformationUnstructured\":\"\",\"purposeCode\":\"dufo\",\"chargeBearer\":\"SHAR\",\"creditorA
Show more open_in_new
OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"debtorAccount\":{\"iban\":\"PT000\",\"bban\":\"1\",\"pan\":\"\",\"maskedPan\":\"\",\"msisdn\":\"\",\"currency\":\"SXR\"},\"debtorName\":\"Lucas Sparks\",\"batchBookingPreferred\":false,\"paymentInformationId\":\"3565709980336128\",\"requestedExecutionDate\":\"2001-01-05\",\"payments\":[{\"instructedAmount\":{\"currency\":\"EUR\",\"content\":\"0\"},\"endToEndIdentification\":\"\",\"creditorAccount\":{\"iban\":\"PT000\",\"bban\":\"1\",\"pan\":\"\",\"maskedPan\":\"\",\"msisdn\":\"\",\"currency\":\"OWI\"},\"creditorAgent\":\"ABCDEFABC0A\",\"creditorName\":\"a\",\"creditorAddress\":{\"street\":\"\",\"buildingNumber\":\"\",\"city\":\"\",\"postalCode\":\"\",\"country\":\"\"},\"creditorClearingCode\":\"4903448233539106\",\"remittanceInformationUnstructured\":\"\",\"purposeCode\":\"icol\",\"chargeBearer\":\"SHAR\",\"creditorAgentName\":\"30074838931581\",\"creditorAgentAddress\":{\"street\":\"\",\"buildingNumber\":\"\",\"city\":\"\",\"postalCode\":\"\",\"country\":\"\"}},{\"instructedAmount\":{\"currency\":\"EUR\",\"content\":\"0\"},\"endToEndIdentification\":\"\",\"creditorAccount\":{\"iban\":\"PT000\",\"bban\":\"1\",\"pan\":\"\",\"maskedPan\":\"\",\"msisdn\":\"\",\"currency\":\"CKN\"},\"creditorAgent\":\"ABCDEFABC0A\",\"creditorName\":\"a\",\"creditorAddress\":{\"street\":\"\",\"buildingNumber\":\"\",\"city\":\"\",\"postalCode\":\"\",\"country\":\"\"},\"creditorClearingCode\":\"6304236509352134\",\"remittanceInformationUnstructured\":\"\",\"purposeCode\":\"dufo\",\"chargeBearer\":\"SHAR\",\"creditorAgentName\":\"5497962127109205\",\"creditorAgentAddress\":{\"street\":\"\",\"buildingNumber\":\"\",\"city\":\"\",\"postalCode\":\"\",\"country\":\"\"}},{\"instructedAmount\":{\"currency\":\"EUR\",\"content\":\"0\"},\"endToEndIdentification\":\"\",\"creditorAccount\":{\"iban\":\"PT000\",\"bban\":\"1\",\"pan\":\"\",\"maskedPan\"
Show more open_in_new
const request = require('request');

const options = {
  method: 'POST',
  url: 'https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers',
  qs: {tppRedirectPreferred: 'REPLACE_THIS_VALUE'},
  headers: {
    'X-IBM-Client-Id': 'REPLACE_THIS_KEY',
    'TPP-Transaction-ID': 'REPLACE_THIS_VALUE',
    'TPP-Request-ID': 'REPLACE_THIS_VALUE',
    'PSU-ID': 'REPLACE_THIS_VALUE',
    'PSU-ID-Type': 'REPLACE_THIS_VALUE',
    'PSU-Corporate-ID': 'REPLACE_THIS_VALUE',
    'PSU-Corporate-ID-Type': 'REPLACE_THIS_VALUE',
    'PSU-Consent-ID': 'REPLACE_THIS_VALUE',
    'PSU-Agent': 'REPLACE_THIS_VALUE',
    'PSU-IP-Address': 'REPLACE_THIS_VALUE',
    'PSU-IP-Port': 'REPLACE_THIS_VALUE',
    'PSU-Device-ID': 'REPLACE_THIS_VALUE',
    'PSU-Device-Fingerprint': 'REPLACE_THIS_VALUE',
    'Transaction-SCA-Performed': 'REPLACE_THIS_VALUE',
    'PSU-Geo-Location': 'GEO:1.111111;-1.111111',
    'TPP-Redirect-URI': 'REPLACE_THIS_VALUE',
    'TPP-Delegated-Preferred': 'REPLACE_THIS_VALUE',
    'Delegation-ID': 'REPLACE_THIS_VALUE',
    Signature: 'REPLACE_THIS_VALUE',
    'TPP-Certificate': 'REPLACE_THIS_VALUE',
    Date: 'REPLACE_THIS_VALUE',
    Digest: 'REPLACE_THIS_VALUE',
    'content-type': 'application/json',
    accept: 'application/json'
  },
  body: {
    debtorAccount: {iban: 'PT000', bban: '1', pan: '', maskedPan: '', msisdn: '', currency: 'SXR'},
    debtorName: 'Lucas Sparks',
    batchBookingPreferred: false,
    paymentInformationId: '3565709980336128',
    requestedExecutionDate: '2001-01-05',
    payments: [
      {
        instructedAmount: {currency: 'EUR', content: '0'},
        endToEndIdentification: '',
        creditorAccount: {iban: 'PT000', bban: '1', pan: '', maskedPan: '', msisdn: '', currency: 'OWI'},
        creditorAgent: 'ABCDEFABC0A',
        creditorName: 'a',
        creditorAddress: {street: '', buildingNumber: '', city: '', postalCode: '', country: ''},
        creditorClearingCode: '4903448233
Show more open_in_new
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers?tppRedirectPreferred=REPLACE_THIS_VALUE"

	payload := strings.NewReader("{\"debtorAccount\":{\"iban\":\"PT000\",\"bban\":\"1\",\"pan\":\"\",\"maskedPan\":\"\",\"msisdn\":\"\",\"currency\":\"SXR\"},\"debtorName\":\"Lucas Sparks\",\"batchBookingPreferred\":false,\"paymentInformationId\":\"3565709980336128\",\"requestedExecutionDate\":\"2001-01-05\",\"payments\":[{\"instructedAmount\":{\"currency\":\"EUR\",\"content\":\"0\"},\"endToEndIdentification\":\"\",\"creditorAccount\":{\"iban\":\"PT000\",\"bban\":\"1\",\"pan\":\"\",\"maskedPan\":\"\",\"msisdn\":\"\",\"currency\":\"OWI\"},\"creditorAgent\":\"ABCDEFABC0A\",\"creditorName\":\"a\",\"creditorAddress\":{\"street\":\"\",\"buildingNumber\":\"\",\"city\":\"\",\"postalCode\":\"\",\"country\":\"\"},\"creditorClearingCode\":\"4903448233539106\",\"remittanceInformationUnstructured\":\"\",\"purposeCode\":\"icol\",\"chargeBearer\":\"SHAR\",\"creditorAgentName\":\"30074838931581\",\"creditorAgentAddress\":{\"street\":\"\",\"buildingNumber\":\"\",\"city\":\"\",\"postalCode\":\"\",\"country\":\"\"}},{\"instructedAmount\":{\"currency\":\"EUR\",\"content\":\"0\"},\"endToEndIdentification\":\"\",\"creditorAccount\":{\"iban\":\"PT000\",\"bban\":\"1\",\"pan\":\"\",\"maskedPan\":\"\",\"msisdn\":\"\",\"currency\":\"CKN\"},\"creditorAgent\":\"ABCDEFABC0A\",\"creditorName\":\"a\",\"creditorAddress\":{\"street\":\"\",\"buildingNumber\":\"\",\"city\":\"\",\"postalCode\":\"\",\"country\":\"\"},\"creditorClearingCode\":\"6304236509352134\",\"remittanceInformationUnstructured\":\"\",\"purposeCode\":\"dufo\",\"chargeBearer\":\"SHAR\",\"creditorAgentName\":\"5497962127109205\",\"creditorAgentAddress\":{\"street\":\"\",\"buildingNumber\":\"\",\"city\":\"\",\"postalCode\":\"\",\"country\":\"\"}},{\"instructedAmount\":{\"currency\":\"EUR\",\"
Show more open_in_new
import Foundation

let headers = [
  "X-IBM-Client-Id": "REPLACE_THIS_KEY",
  "TPP-Transaction-ID": "REPLACE_THIS_VALUE",
  "TPP-Request-ID": "REPLACE_THIS_VALUE",
  "PSU-ID": "REPLACE_THIS_VALUE",
  "PSU-ID-Type": "REPLACE_THIS_VALUE",
  "PSU-Corporate-ID": "REPLACE_THIS_VALUE",
  "PSU-Corporate-ID-Type": "REPLACE_THIS_VALUE",
  "PSU-Consent-ID": "REPLACE_THIS_VALUE",
  "PSU-Agent": "REPLACE_THIS_VALUE",
  "PSU-IP-Address": "REPLACE_THIS_VALUE",
  "PSU-IP-Port": "REPLACE_THIS_VALUE",
  "PSU-Device-ID": "REPLACE_THIS_VALUE",
  "PSU-Device-Fingerprint": "REPLACE_THIS_VALUE",
  "Transaction-SCA-Performed": "REPLACE_THIS_VALUE",
  "PSU-Geo-Location": "GEO:1.111111;-1.111111",
  "TPP-Redirect-URI": "REPLACE_THIS_VALUE",
  "TPP-Delegated-Preferred": "REPLACE_THIS_VALUE",
  "Delegation-ID": "REPLACE_THIS_VALUE",
  "Signature": "REPLACE_THIS_VALUE",
  "TPP-Certificate": "REPLACE_THIS_VALUE",
  "Date": "REPLACE_THIS_VALUE",
  "Digest": "REPLACE_THIS_VALUE",
  "content-type": "application/json",
  "accept": "application/json"
]
let parameters = [
  "debtorAccount": [
    "iban": "PT000",
    "bban": "1",
    "pan": "",
    "maskedPan": "",
    "msisdn": "",
    "currency": "SXR"
  ],
  "debtorName": "Lucas Sparks",
  "batchBookingPreferred": false,
  "paymentInformationId": "3565709980336128",
  "requestedExecutionDate": "2001-01-05",
  "payments": [
    [
      "instructedAmount": [
        "currency": "EUR",
        "content": "0"
      ],
      "endToEndIdentification": "",
      "creditorAccount": [
        "iban": "PT000",
        "bban": "1",
        "pan": "",
        "maskedPan": "",
        "msisdn": "",
        "currency": "OWI"
      ],
      "creditorAgent": "ABCDEFABC0A",
      "creditorName": "a",
      "creditorAddress": [
        "street": "",
        "buildingNumber": "",
        "city": "",
        "postalCode": "",
        "country": ""
      ],
      "creditorClearingCode": "4903448233539106",
      "remittanceInformationUnstructured": "",
      "purposeC
Show more open_in_new
Example Response
POST https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/{aspsp-cde}/v1-0-3/bulk-payments/{payment-product}
{
  "transactionStatus": "RJCT",
  "bulkPaymentId": "",
  "transactionFees": {
    "currency": "EUR",
    "content": "0"
  },
  "transactionFeeIndicator": false,
  "scaMethods": [
    {
      "authenticationType": "SMS_OTP",
      "authenticationVersion": "",
      "authenticationMethodId": "",
      "name": "",
      "explanation": ""
    }
  ],
  "chosenScaMethod": {
    "authenticationType": "SMS_OTP",
    "authenticationVersion": "",
    "authenticationMethodId": "",
    "name": "",
    "explanation": ""
  },
  "challengeData": {
    "image": "",
    "data": "",
    "imageLink": "",
    "otpMaxLength": 0,
    "otpFormat": "integer",
    "additionalInformation": ""
  },
  "_links": {
    "redirect": "",
    "updatePsuIdentification": "",
    "updatePsuAuthentication": "",
    "selectAuthenticationMethod": "",
    "authoriseTransaction": "",
    "self": "",
    "updateProprietaryData": "",
    "status": ""
  },
  "psuMessage": "",
  "tppMessages": [
    {
      "category": "",
Show more open_in_new
Try this operation
https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/{aspsp-cde}/v1-0-3/bulk-payments/{payment-product}
Login to test this API.
content-type
accept
TPP-Transaction-ID
TPP-Request-ID
PSU-ID
PSU-ID-Type
PSU-Corporate-ID
PSU-Corporate-ID-Type
PSU-Consent-ID
PSU-Agent
PSU-IP-Address
PSU-IP-Port
PSU-Device-ID
PSU-Device-Fingerprint
Transaction-SCA-Performed
PSU-Geo-Location
TPP-Redirect-URI
TPP-Delegated-Preferred
Delegation-ID
Signature
TPP-Certificate
Date
Digest
aspsp-cde
payment-product
tppRedirectPreferred

/{aspsp-cde}/v1-0-3/bulk-payments/{payment-product}/{bulk-payment-id}

put /{aspsp-cde}/v1-0-3/bulk-payments/{payment-product}/{bulk-payment-id}
BulkPaymentUpdateRequest

Bulk Payment Update Request

Updates information related to a previous bulk payment initiation in order to obtain PSUId credentials.

x-ibm-client-id
X-IBM-Client-Id
(apiKey located in header)
aspsp-cde
Required in path
string

Identification of the aspsp

{
    "default": ""
}
payment-product
Required in path
string

Type of payment

{
    "default": "sepa-credit-transfers",
    "enum": [
        "sepa-credit-transfers",
        "cross-border-credit-transfers",
        "instant-sepa-credit-transfers",
        "target-2-payments",
        "sdcl-sepa-credit-transfers",
        "urgent-sepa-credit-transfers"
    ]
}
bulk-payment-id
Required in path
string

Identification of the bulk payment

{
    "default": ""
}
TPP-Transaction-ID
Required in header
string / uuid

ID of the transaction as determined by the initiating party.

{
    "default": ""
}
TPP-Request-ID
Required in header
string / uuid

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

{
    "default": ""
}
PSU-ID
Optional in header
string

User identification in ASPSP

{
    "default": ""
}
PSU-ID-Type
Optional in header
string

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

{
    "default": ""
}
PSU-Corporate-ID
Optional in header
string

Corporate User identification in ASPSP

{
    "default": ""
}
PSU-Corporate-ID-Type
Optional in header
string

Might be mandated in the ASPSPs documentation. Only used in a corporate context.

{
    "default": ""
}
Signature
Required in header
string

A signature of the request by the TPP on application level. This might be mandated by ASPSP.

{
    "default": ""
}
TPP-Certificate
Required in header
string

The certificate used for signing the request, in base64 encoding. Shall be contained if the signature is used.

{
    "default": ""
}
Date
Required in header
string / date-time

Request date

{
    "pattern": "yyyy-MM-dd'T'hh:MM:ss.SSS"
}
BulkPaymentUpdateRequest
Optional in body
object

Bulk Payment Update Request

{
    "schema": {
        "description": "Updates information related to a previous bulk payment initiation in order to obtain PSUId credentials.",
        "type": "object",
        "properties": {
            "psuData": {
                "$ref": "#\/definitions\/PSUData",
                "description": "Include all credentials related data (e.g., user, password and additional data accordingly with ASPSP requests)"
            },
            "scaAuthenticationData": {
                "description": "SCA authentication data, depending on the chosen authentication method.\n\nif the data is binary, then it is base64 encoded.",
                "type": "string",
                "default": ""
            },
            "authenticationMethodId": {
                "description": "The authentication method ID as provided by the ASPSP. This property is mandatory in a Select Authentication Method.",
                "type": "string",
                "default": ""
            }
        },
        "additionalProperties": false
    }
}
Digest
Optional in header
string

Hash of the message body. Should be present when Request body exists

{
    "default": ""
}
Content-Type
Optional in header
string
application/json
Accept
Optional in header
string
application/json
201

Created

BulkPaymentUpdateResponseResource
400

Bad Request.

ErrorMessageWithStatus
401

Unauthorized.

ErrorMessageWithStatus
403

Forbidden.

ErrorMessageWithStatus
404

Not Found.

ErrorMessageWithStatus
405

Method Not Allowed.

ErrorMessageWithStatus
406

Not Acceptable.

ErrorMessageWithStatus
408

Request Timeout.

ErrorMessageWithStatus
415

Unsupported Media Type.

ErrorMessageWithStatus
429

Too Many Requests.

ErrorMessageWithStatus
500

Internal Server Error.

ErrorMessageWithStatus
503

Service Unavailable.

ErrorMessageWithStatus
504

Gatewaty Timeout.

ErrorMessageWithStatus
Example Request
curl --request PUT \
  --url https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID \
  --header 'Date: REPLACE_THIS_VALUE' \
  --header 'Digest: REPLACE_THIS_VALUE' \
  --header 'PSU-Corporate-ID: REPLACE_THIS_VALUE' \
  --header 'PSU-Corporate-ID-Type: REPLACE_THIS_VALUE' \
  --header 'PSU-ID: REPLACE_THIS_VALUE' \
  --header 'PSU-ID-Type: REPLACE_THIS_VALUE' \
  --header 'Signature: REPLACE_THIS_VALUE' \
  --header 'TPP-Certificate: REPLACE_THIS_VALUE' \
  --header 'TPP-Request-ID: REPLACE_THIS_VALUE' \
  --header 'TPP-Transaction-ID: REPLACE_THIS_VALUE' \
  --header 'X-IBM-Client-Id: REPLACE_THIS_KEY' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{"psuData":{"password":"1"},"scaAuthenticationData":"","authenticationMethodId":""}'
require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Put.new(url)
request["X-IBM-Client-Id"] = 'REPLACE_THIS_KEY'
request["TPP-Transaction-ID"] = 'REPLACE_THIS_VALUE'
request["TPP-Request-ID"] = 'REPLACE_THIS_VALUE'
request["PSU-ID"] = 'REPLACE_THIS_VALUE'
request["PSU-ID-Type"] = 'REPLACE_THIS_VALUE'
request["PSU-Corporate-ID"] = 'REPLACE_THIS_VALUE'
request["PSU-Corporate-ID-Type"] = 'REPLACE_THIS_VALUE'
request["Signature"] = 'REPLACE_THIS_VALUE'
request["TPP-Certificate"] = 'REPLACE_THIS_VALUE'
request["Date"] = 'REPLACE_THIS_VALUE'
request["Digest"] = 'REPLACE_THIS_VALUE'
request["content-type"] = 'application/json'
request["accept"] = 'application/json'
request.body = "{\"psuData\":{\"password\":\"1\"},\"scaAuthenticationData\":\"\",\"authenticationMethodId\":\"\"}"

response = http.request(request)
puts response.read_body
import http.client

conn = http.client.HTTPSConnection("site1.sibsapimarket.com:8445")

payload = "{\"psuData\":{\"password\":\"1\"},\"scaAuthenticationData\":\"\",\"authenticationMethodId\":\"\"}"

headers = {
    'X-IBM-Client-Id': "REPLACE_THIS_KEY",
    'TPP-Transaction-ID': "REPLACE_THIS_VALUE",
    'TPP-Request-ID': "REPLACE_THIS_VALUE",
    'PSU-ID': "REPLACE_THIS_VALUE",
    'PSU-ID-Type': "REPLACE_THIS_VALUE",
    'PSU-Corporate-ID': "REPLACE_THIS_VALUE",
    'PSU-Corporate-ID-Type': "REPLACE_THIS_VALUE",
    'Signature': "REPLACE_THIS_VALUE",
    'TPP-Certificate': "REPLACE_THIS_VALUE",
    'Date': "REPLACE_THIS_VALUE",
    'Digest': "REPLACE_THIS_VALUE",
    'content-type': "application/json",
    'accept': "application/json"
    }

conn.request("PUT", "/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID", payload, headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "8445",
  CURLOPT_URL => "https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => "{\"psuData\":{\"password\":\"1\"},\"scaAuthenticationData\":\"\",\"authenticationMethodId\":\"\"}",
  CURLOPT_HTTPHEADER => [
    "Date: REPLACE_THIS_VALUE",
    "Digest: REPLACE_THIS_VALUE",
    "PSU-Corporate-ID: REPLACE_THIS_VALUE",
    "PSU-Corporate-ID-Type: REPLACE_THIS_VALUE",
    "PSU-ID: REPLACE_THIS_VALUE",
    "PSU-ID-Type: REPLACE_THIS_VALUE",
    "Signature: REPLACE_THIS_VALUE",
    "TPP-Certificate: REPLACE_THIS_VALUE",
    "TPP-Request-ID: REPLACE_THIS_VALUE",
    "TPP-Transaction-ID: REPLACE_THIS_VALUE",
    "X-IBM-Client-Id: REPLACE_THIS_KEY",
    "accept: application/json",
    "content-type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"psuData\":{\"password\":\"1\"},\"scaAuthenticationData\":\"\",\"authenticationMethodId\":\"\"}");
Request request = new Request.Builder()
  .url("https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID")
  .put(body)
  .addHeader("X-IBM-Client-Id", "REPLACE_THIS_KEY")
  .addHeader("TPP-Transaction-ID", "REPLACE_THIS_VALUE")
  .addHeader("TPP-Request-ID", "REPLACE_THIS_VALUE")
  .addHeader("PSU-ID", "REPLACE_THIS_VALUE")
  .addHeader("PSU-ID-Type", "REPLACE_THIS_VALUE")
  .addHeader("PSU-Corporate-ID", "REPLACE_THIS_VALUE")
  .addHeader("PSU-Corporate-ID-Type", "REPLACE_THIS_VALUE")
  .addHeader("Signature", "REPLACE_THIS_VALUE")
  .addHeader("TPP-Certificate", "REPLACE_THIS_VALUE")
  .addHeader("Date", "REPLACE_THIS_VALUE")
  .addHeader("Digest", "REPLACE_THIS_VALUE")
  .addHeader("content-type", "application/json")
  .addHeader("accept", "application/json")
  .build();

Response response = client.newCall(request).execute();
const request = require('request');

const options = {
  method: 'PUT',
  url: 'https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID',
  headers: {
    'X-IBM-Client-Id': 'REPLACE_THIS_KEY',
    'TPP-Transaction-ID': 'REPLACE_THIS_VALUE',
    'TPP-Request-ID': 'REPLACE_THIS_VALUE',
    'PSU-ID': 'REPLACE_THIS_VALUE',
    'PSU-ID-Type': 'REPLACE_THIS_VALUE',
    'PSU-Corporate-ID': 'REPLACE_THIS_VALUE',
    'PSU-Corporate-ID-Type': 'REPLACE_THIS_VALUE',
    Signature: 'REPLACE_THIS_VALUE',
    'TPP-Certificate': 'REPLACE_THIS_VALUE',
    Date: 'REPLACE_THIS_VALUE',
    Digest: 'REPLACE_THIS_VALUE',
    'content-type': 'application/json',
    accept: 'application/json'
  },
  body: {
    psuData: {password: '1'},
    scaAuthenticationData: '',
    authenticationMethodId: ''
  },
  json: true
};

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID"

	payload := strings.NewReader("{\"psuData\":{\"password\":\"1\"},\"scaAuthenticationData\":\"\",\"authenticationMethodId\":\"\"}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("X-IBM-Client-Id", "REPLACE_THIS_KEY")
	req.Header.Add("TPP-Transaction-ID", "REPLACE_THIS_VALUE")
	req.Header.Add("TPP-Request-ID", "REPLACE_THIS_VALUE")
	req.Header.Add("PSU-ID", "REPLACE_THIS_VALUE")
	req.Header.Add("PSU-ID-Type", "REPLACE_THIS_VALUE")
	req.Header.Add("PSU-Corporate-ID", "REPLACE_THIS_VALUE")
	req.Header.Add("PSU-Corporate-ID-Type", "REPLACE_THIS_VALUE")
	req.Header.Add("Signature", "REPLACE_THIS_VALUE")
	req.Header.Add("TPP-Certificate", "REPLACE_THIS_VALUE")
	req.Header.Add("Date", "REPLACE_THIS_VALUE")
	req.Header.Add("Digest", "REPLACE_THIS_VALUE")
	req.Header.Add("content-type", "application/json")
	req.Header.Add("accept", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
import Foundation

let headers = [
  "X-IBM-Client-Id": "REPLACE_THIS_KEY",
  "TPP-Transaction-ID": "REPLACE_THIS_VALUE",
  "TPP-Request-ID": "REPLACE_THIS_VALUE",
  "PSU-ID": "REPLACE_THIS_VALUE",
  "PSU-ID-Type": "REPLACE_THIS_VALUE",
  "PSU-Corporate-ID": "REPLACE_THIS_VALUE",
  "PSU-Corporate-ID-Type": "REPLACE_THIS_VALUE",
  "Signature": "REPLACE_THIS_VALUE",
  "TPP-Certificate": "REPLACE_THIS_VALUE",
  "Date": "REPLACE_THIS_VALUE",
  "Digest": "REPLACE_THIS_VALUE",
  "content-type": "application/json",
  "accept": "application/json"
]
let parameters = [
  "psuData": ["password": "1"],
  "scaAuthenticationData": "",
  "authenticationMethodId": ""
] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "PUT"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
Example Response
PUT https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/{aspsp-cde}/v1-0-3/bulk-payments/{payment-product}/{bulk-payment-id}
{
  "transactionStatus": "RJCT",
  "psuMessage": "",
  "tppMessages": [
    {
      "category": "",
      "code": "CONSENT_INVALID",
      "path": "",
      "text": ""
    }
  ],
  "scaMethods": [
    {
      "authenticationType": "SMS_OTP",
      "authenticationVersion": "",
      "authenticationMethodId": "",
      "name": "",
      "explanation": ""
    }
  ],
  "chosenScaMethod": {
    "authenticationType": "SMS_OTP",
    "authenticationVersion": "",
    "authenticationMethodId": "",
    "name": "",
    "explanation": ""
  },
  "challengeData": {
    "image": "",
    "data": "",
    "imageLink": "",
    "otpMaxLength": 0,
    "otpFormat": "integer",
    "additionalInformation": ""
  },
  "_links": {
    "redirect": "",
    "updatePsuIdentification": "",
    "updatePsuAuthentication": "",
    "selectAuthenticationMethod": "",
    "authoriseTransaction": "",
    "self": "",
    "updateProprietaryData": "",
    "status": ""
  }
}
Try this operation
https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/{aspsp-cde}/v1-0-3/bulk-payments/{payment-product}/{bulk-payment-id}
Login to test this API.
content-type
accept
TPP-Transaction-ID
TPP-Request-ID
PSU-ID
PSU-ID-Type
PSU-Corporate-ID
PSU-Corporate-ID-Type
Signature
TPP-Certificate
Date
Digest
aspsp-cde
payment-product
bulk-payment-id
get /{aspsp-cde}/v1-0-3/bulk-payments/{payment-product}/{bulk-payment-id}
Get Bulk Payment Request

Get Bulk Payment Request

Requests the content of a bulk payment initiation object. This is returning the data for the TPP especially in cases, where the consent was directly managed between ASPSP and PSU e.g. in a re-direct SCA Approach.

x-ibm-client-id
X-IBM-Client-Id
(apiKey located in header)
aspsp-cde
Required in path
string

Identification of the aspsp

{
    "default": ""
}
payment-product
Required in path
string

Type of payment

{
    "default": "sepa-credit-transfers",
    "enum": [
        "sepa-credit-transfers",
        "cross-border-credit-transfers",
        "instant-sepa-credit-transfers",
        "target-2-payments",
        "sdcl-sepa-credit-transfers",
        "urgent-sepa-credit-transfers"
    ]
}
bulk-payment-id
Required in path
string

Identification of the bulk payment

{
    "default": ""
}
TPP-Transaction-ID
Required in header
string / uuid

ID of the transaction as determined by the initiating party.

{
    "default": ""
}
TPP-Request-ID
Required in header
string / uuid

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

{
    "default": ""
}
PSU-ID
Optional in header
string

User identification in ASPSP

{
    "default": ""
}
PSU-ID-Type
Optional in header
string

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

{
    "default": ""
}
PSU-Corporate-ID
Optional in header
string

Corporate User identification in ASPSP

{
    "default": ""
}
PSU-Corporate-ID-Type
Optional in header
string

Might be mandated in the ASPSPs documentation. Only used in a corporate context.

{
    "default": ""
}
Signature
Required in header
string

A signature of the request by the TPP on application level. This might be mandated by ASPSP.

{
    "default": ""
}
TPP-Certificate
Required in header
string

The certificate used for signing the request, in base64 encoding. Shall be contained if the signature is used.

{
    "default": ""
}
Date
Required in header
string / date-time

Request date

{
    "pattern": "yyyy-MM-dd'T'hh:MM:ss.SSS"
}
Accept
Optional in header
string
application/json
200

OK

BulkPaymentDetailsResponseResource
400

Bad Request.

ErrorMessageWithStatus
401

Unauthorized.

ErrorMessageWithStatus
403

Forbidden.

ErrorMessageWithStatus
404

Not Found.

ErrorMessageWithStatus
405

Method Not Allowed.

ErrorMessageWithStatus
406

Not Acceptable.

ErrorMessageWithStatus
408

Request Timeout.

ErrorMessageWithStatus
415

Unsupported Media Type.

ErrorMessageWithStatus
429

Too Many Requests.

ErrorMessageWithStatus
500

Internal Server Error.

ErrorMessageWithStatus
503

Service Unavailable.

ErrorMessageWithStatus
504

Gatewaty Timeout.

ErrorMessageWithStatus
Example Request
curl --request GET \
  --url https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID \
  --header 'Date: REPLACE_THIS_VALUE' \
  --header 'PSU-Corporate-ID: REPLACE_THIS_VALUE' \
  --header 'PSU-Corporate-ID-Type: REPLACE_THIS_VALUE' \
  --header 'PSU-ID: REPLACE_THIS_VALUE' \
  --header 'PSU-ID-Type: REPLACE_THIS_VALUE' \
  --header 'Signature: REPLACE_THIS_VALUE' \
  --header 'TPP-Certificate: REPLACE_THIS_VALUE' \
  --header 'TPP-Request-ID: REPLACE_THIS_VALUE' \
  --header 'TPP-Transaction-ID: REPLACE_THIS_VALUE' \
  --header 'X-IBM-Client-Id: REPLACE_THIS_KEY' \
  --header 'accept: application/json'
require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Get.new(url)
request["X-IBM-Client-Id"] = 'REPLACE_THIS_KEY'
request["TPP-Transaction-ID"] = 'REPLACE_THIS_VALUE'
request["TPP-Request-ID"] = 'REPLACE_THIS_VALUE'
request["PSU-ID"] = 'REPLACE_THIS_VALUE'
request["PSU-ID-Type"] = 'REPLACE_THIS_VALUE'
request["PSU-Corporate-ID"] = 'REPLACE_THIS_VALUE'
request["PSU-Corporate-ID-Type"] = 'REPLACE_THIS_VALUE'
request["Signature"] = 'REPLACE_THIS_VALUE'
request["TPP-Certificate"] = 'REPLACE_THIS_VALUE'
request["Date"] = 'REPLACE_THIS_VALUE'
request["accept"] = 'application/json'

response = http.request(request)
puts response.read_body
import http.client

conn = http.client.HTTPSConnection("site1.sibsapimarket.com:8445")

headers = {
    'X-IBM-Client-Id': "REPLACE_THIS_KEY",
    'TPP-Transaction-ID': "REPLACE_THIS_VALUE",
    'TPP-Request-ID': "REPLACE_THIS_VALUE",
    'PSU-ID': "REPLACE_THIS_VALUE",
    'PSU-ID-Type': "REPLACE_THIS_VALUE",
    'PSU-Corporate-ID': "REPLACE_THIS_VALUE",
    'PSU-Corporate-ID-Type': "REPLACE_THIS_VALUE",
    'Signature': "REPLACE_THIS_VALUE",
    'TPP-Certificate': "REPLACE_THIS_VALUE",
    'Date': "REPLACE_THIS_VALUE",
    'accept': "application/json"
    }

conn.request("GET", "/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "8445",
  CURLOPT_URL => "https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Date: REPLACE_THIS_VALUE",
    "PSU-Corporate-ID: REPLACE_THIS_VALUE",
    "PSU-Corporate-ID-Type: REPLACE_THIS_VALUE",
    "PSU-ID: REPLACE_THIS_VALUE",
    "PSU-ID-Type: REPLACE_THIS_VALUE",
    "Signature: REPLACE_THIS_VALUE",
    "TPP-Certificate: REPLACE_THIS_VALUE",
    "TPP-Request-ID: REPLACE_THIS_VALUE",
    "TPP-Transaction-ID: REPLACE_THIS_VALUE",
    "X-IBM-Client-Id: REPLACE_THIS_KEY",
    "accept: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID")
  .get()
  .addHeader("X-IBM-Client-Id", "REPLACE_THIS_KEY")
  .addHeader("TPP-Transaction-ID", "REPLACE_THIS_VALUE")
  .addHeader("TPP-Request-ID", "REPLACE_THIS_VALUE")
  .addHeader("PSU-ID", "REPLACE_THIS_VALUE")
  .addHeader("PSU-ID-Type", "REPLACE_THIS_VALUE")
  .addHeader("PSU-Corporate-ID", "REPLACE_THIS_VALUE")
  .addHeader("PSU-Corporate-ID-Type", "REPLACE_THIS_VALUE")
  .addHeader("Signature", "REPLACE_THIS_VALUE")
  .addHeader("TPP-Certificate", "REPLACE_THIS_VALUE")
  .addHeader("Date", "REPLACE_THIS_VALUE")
  .addHeader("accept", "application/json")
  .build();

Response response = client.newCall(request).execute();
const request = require('request');

const options = {
  method: 'GET',
  url: 'https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID',
  headers: {
    'X-IBM-Client-Id': 'REPLACE_THIS_KEY',
    'TPP-Transaction-ID': 'REPLACE_THIS_VALUE',
    'TPP-Request-ID': 'REPLACE_THIS_VALUE',
    'PSU-ID': 'REPLACE_THIS_VALUE',
    'PSU-ID-Type': 'REPLACE_THIS_VALUE',
    'PSU-Corporate-ID': 'REPLACE_THIS_VALUE',
    'PSU-Corporate-ID-Type': 'REPLACE_THIS_VALUE',
    Signature: 'REPLACE_THIS_VALUE',
    'TPP-Certificate': 'REPLACE_THIS_VALUE',
    Date: 'REPLACE_THIS_VALUE',
    accept: 'application/json'
  }
};

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-IBM-Client-Id", "REPLACE_THIS_KEY")
	req.Header.Add("TPP-Transaction-ID", "REPLACE_THIS_VALUE")
	req.Header.Add("TPP-Request-ID", "REPLACE_THIS_VALUE")
	req.Header.Add("PSU-ID", "REPLACE_THIS_VALUE")
	req.Header.Add("PSU-ID-Type", "REPLACE_THIS_VALUE")
	req.Header.Add("PSU-Corporate-ID", "REPLACE_THIS_VALUE")
	req.Header.Add("PSU-Corporate-ID-Type", "REPLACE_THIS_VALUE")
	req.Header.Add("Signature", "REPLACE_THIS_VALUE")
	req.Header.Add("TPP-Certificate", "REPLACE_THIS_VALUE")
	req.Header.Add("Date", "REPLACE_THIS_VALUE")
	req.Header.Add("accept", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
import Foundation

let headers = [
  "X-IBM-Client-Id": "REPLACE_THIS_KEY",
  "TPP-Transaction-ID": "REPLACE_THIS_VALUE",
  "TPP-Request-ID": "REPLACE_THIS_VALUE",
  "PSU-ID": "REPLACE_THIS_VALUE",
  "PSU-ID-Type": "REPLACE_THIS_VALUE",
  "PSU-Corporate-ID": "REPLACE_THIS_VALUE",
  "PSU-Corporate-ID-Type": "REPLACE_THIS_VALUE",
  "Signature": "REPLACE_THIS_VALUE",
  "TPP-Certificate": "REPLACE_THIS_VALUE",
  "Date": "REPLACE_THIS_VALUE",
  "accept": "application/json"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
Example Response
GET https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/{aspsp-cde}/v1-0-3/bulk-payments/{payment-product}/{bulk-payment-id}
{
  "transactionStatus": "RJCT",
  "bulkPaymentId": "",
  "debtorAccount": {
    "iban": "PT000",
    "bban": "1",
    "pan": "",
    "maskedPan": "",
    "msisdn": "",
    "currency": "HZM"
  },
  "debtorName": "Ollie Thornton",
  "batchBookingPreferred": false,
  "paymentInformationId": "6628199133872128",
  "requestedExecutionDate": "9999-12-31",
  "transactionFees": {
    "currency": "EUR",
    "content": "0"
  },
  "transactionFeeIndicator": true,
  "payments": [
    {
      "instructedAmount": {
        "currency": "EUR",
        "content": "0"
      },
      "endToEndIdentification": "",
      "creditorAccount": {
        "iban": "PT000",
        "bban": "1",
        "pan": "",
        "maskedPan": "",
        "msisdn": "",
        "currency": "KSI"
      },
      "creditorAgent": "ABCDEFABC0A",
      "creditorName": "a",
      "creditorAddress": {
        "street": "",
        "buildingNumber": "",
        "city": "",
        "postalCode": "",
        "country": ""
      },
Show more open_in_new
Try this operation
https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/{aspsp-cde}/v1-0-3/bulk-payments/{payment-product}/{bulk-payment-id}
Login to test this API.
accept
TPP-Transaction-ID
TPP-Request-ID
PSU-ID
PSU-ID-Type
PSU-Corporate-ID
PSU-Corporate-ID-Type
Signature
TPP-Certificate
Date
aspsp-cde
payment-product
bulk-payment-id
delete /{aspsp-cde}/v1-0-3/bulk-payments/{payment-product}/{bulk-payment-id}
Cancel Bulk Payment Request

Cancel Bulk Payment Request

Cancels a bulk payment initiation request at the ASPSP.

x-ibm-client-id
X-IBM-Client-Id
(apiKey located in header)
aspsp-cde
Required in path
string

Identification of the aspsp

{
    "default": ""
}
payment-product
Required in path
string

Type of payment

{
    "default": "sepa-credit-transfers",
    "enum": [
        "sepa-credit-transfers",
        "cross-border-credit-transfers",
        "instant-sepa-credit-transfers",
        "target-2-payments",
        "sdcl-sepa-credit-transfers",
        "urgent-sepa-credit-transfers"
    ]
}
bulk-payment-id
Required in path
string

Identification of the bulk payment

{
    "default": ""
}
TPP-Transaction-ID
Required in header
string / uuid

ID of the transaction as determined by the initiating party.

{
    "default": ""
}
TPP-Request-ID
Required in header
string / uuid

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

{
    "default": ""
}
Signature
Required in header
string

A signature of the request by the TPP on application level. This might be mandated by ASPSP.

{
    "default": ""
}
TPP-Certificate
Required in header
string

The certificate used for signing the request, in base64 encoding. Shall be contained if the signature is used.

{
    "default": ""
}
TPP-Redirect-URI
Optional in header
string

URI of the TPP, where the transaction flow shall be redirected to after a Redirect. Shall be contained at least if the tppRedirectPreferred parameter is set to true or is missing.

{
    "default": ""
}
Date
Required in header
string / date-time

Request date

{
    "pattern": "yyyy-MM-dd'T'hh:MM:ss.SSS"
}
Accept
Optional in header
string
application/json
200

OK.

BulkPaymentDeleteResponseResource
400

Bad Request.

ErrorMessageWithStatus
401

Unauthorized.

ErrorMessageWithStatus
403

Forbidden.

ErrorMessageWithStatus
404

Not Found.

ErrorMessageWithStatus
405

Method Not Allowed.

ErrorMessageWithStatus
406

Not Acceptable.

ErrorMessageWithStatus
408

Request Timeout.

ErrorMessageWithStatus
415

Unsupported Media Type.

ErrorMessageWithStatus
429

Too Many Requests.

ErrorMessageWithStatus
500

Internal Server Error.

ErrorMessageWithStatus
503

Service Unavailable.

ErrorMessageWithStatus
504

Gatewaty Timeout.

ErrorMessageWithStatus
Example Request
curl --request DELETE \
  --url https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID \
  --header 'Date: REPLACE_THIS_VALUE' \
  --header 'Signature: REPLACE_THIS_VALUE' \
  --header 'TPP-Certificate: REPLACE_THIS_VALUE' \
  --header 'TPP-Redirect-URI: REPLACE_THIS_VALUE' \
  --header 'TPP-Request-ID: REPLACE_THIS_VALUE' \
  --header 'TPP-Transaction-ID: REPLACE_THIS_VALUE' \
  --header 'X-IBM-Client-Id: REPLACE_THIS_KEY' \
  --header 'accept: application/json'
require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Delete.new(url)
request["X-IBM-Client-Id"] = 'REPLACE_THIS_KEY'
request["TPP-Transaction-ID"] = 'REPLACE_THIS_VALUE'
request["TPP-Request-ID"] = 'REPLACE_THIS_VALUE'
request["Signature"] = 'REPLACE_THIS_VALUE'
request["TPP-Certificate"] = 'REPLACE_THIS_VALUE'
request["TPP-Redirect-URI"] = 'REPLACE_THIS_VALUE'
request["Date"] = 'REPLACE_THIS_VALUE'
request["accept"] = 'application/json'

response = http.request(request)
puts response.read_body
import http.client

conn = http.client.HTTPSConnection("site1.sibsapimarket.com:8445")

headers = {
    'X-IBM-Client-Id': "REPLACE_THIS_KEY",
    'TPP-Transaction-ID': "REPLACE_THIS_VALUE",
    'TPP-Request-ID': "REPLACE_THIS_VALUE",
    'Signature': "REPLACE_THIS_VALUE",
    'TPP-Certificate': "REPLACE_THIS_VALUE",
    'TPP-Redirect-URI': "REPLACE_THIS_VALUE",
    'Date': "REPLACE_THIS_VALUE",
    'accept': "application/json"
    }

conn.request("DELETE", "/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "8445",
  CURLOPT_URL => "https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Date: REPLACE_THIS_VALUE",
    "Signature: REPLACE_THIS_VALUE",
    "TPP-Certificate: REPLACE_THIS_VALUE",
    "TPP-Redirect-URI: REPLACE_THIS_VALUE",
    "TPP-Request-ID: REPLACE_THIS_VALUE",
    "TPP-Transaction-ID: REPLACE_THIS_VALUE",
    "X-IBM-Client-Id: REPLACE_THIS_KEY",
    "accept: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID")
  .delete(null)
  .addHeader("X-IBM-Client-Id", "REPLACE_THIS_KEY")
  .addHeader("TPP-Transaction-ID", "REPLACE_THIS_VALUE")
  .addHeader("TPP-Request-ID", "REPLACE_THIS_VALUE")
  .addHeader("Signature", "REPLACE_THIS_VALUE")
  .addHeader("TPP-Certificate", "REPLACE_THIS_VALUE")
  .addHeader("TPP-Redirect-URI", "REPLACE_THIS_VALUE")
  .addHeader("Date", "REPLACE_THIS_VALUE")
  .addHeader("accept", "application/json")
  .build();

Response response = client.newCall(request).execute();
const request = require('request');

const options = {
  method: 'DELETE',
  url: 'https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID',
  headers: {
    'X-IBM-Client-Id': 'REPLACE_THIS_KEY',
    'TPP-Transaction-ID': 'REPLACE_THIS_VALUE',
    'TPP-Request-ID': 'REPLACE_THIS_VALUE',
    Signature: 'REPLACE_THIS_VALUE',
    'TPP-Certificate': 'REPLACE_THIS_VALUE',
    'TPP-Redirect-URI': 'REPLACE_THIS_VALUE',
    Date: 'REPLACE_THIS_VALUE',
    accept: 'application/json'
  }
};

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("X-IBM-Client-Id", "REPLACE_THIS_KEY")
	req.Header.Add("TPP-Transaction-ID", "REPLACE_THIS_VALUE")
	req.Header.Add("TPP-Request-ID", "REPLACE_THIS_VALUE")
	req.Header.Add("Signature", "REPLACE_THIS_VALUE")
	req.Header.Add("TPP-Certificate", "REPLACE_THIS_VALUE")
	req.Header.Add("TPP-Redirect-URI", "REPLACE_THIS_VALUE")
	req.Header.Add("Date", "REPLACE_THIS_VALUE")
	req.Header.Add("accept", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
import Foundation

let headers = [
  "X-IBM-Client-Id": "REPLACE_THIS_KEY",
  "TPP-Transaction-ID": "REPLACE_THIS_VALUE",
  "TPP-Request-ID": "REPLACE_THIS_VALUE",
  "Signature": "REPLACE_THIS_VALUE",
  "TPP-Certificate": "REPLACE_THIS_VALUE",
  "TPP-Redirect-URI": "REPLACE_THIS_VALUE",
  "Date": "REPLACE_THIS_VALUE",
  "accept": "application/json"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "DELETE"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
Example Response
DELETE https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/{aspsp-cde}/v1-0-3/bulk-payments/{payment-product}/{bulk-payment-id}
{
  "transactionStatus": "RJCT",
  "_links": {
    "redirect": "",
    "updatePsuIdentification": "",
    "updatePsuAuthentication": "",
    "selectAuthenticationMethod": "",
    "authoriseTransaction": "",
    "self": "",
    "updateProprietaryData": "",
    "status": ""
  },
  "psuMessage": "43",
  "tppMessage": [
    {
      "category": "",
      "code": "CONSENT_INVALID",
      "path": "",
      "text": ""
    }
  ],
  "transactionFees": {
    "currency": "EUR",
    "content": "0"
  },
  "transactionFeeIndicator": true,
  "scaMethods": [
    {
      "authenticationType": "SMS_OTP",
      "authenticationVersion": "",
      "authenticationMethodId": "",
      "name": "",
      "explanation": ""
    }
  ]
}
Try this operation
https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/{aspsp-cde}/v1-0-3/bulk-payments/{payment-product}/{bulk-payment-id}
Login to test this API.
accept
TPP-Transaction-ID
TPP-Request-ID
Signature
TPP-Certificate
TPP-Redirect-URI
Date
aspsp-cde
payment-product
bulk-payment-id

/{aspsp-cde}/v1-0-3/bulk-payments/{payment-product}/{bulk-payment-id}/status

get /{aspsp-cde}/v1-0-3/bulk-payments/{payment-product}/{bulk-payment-id}/status
Get Bulk Status Request

Get Bulk Status Request

Request to check the status of a bulk payment initiation.

x-ibm-client-id
X-IBM-Client-Id
(apiKey located in header)
aspsp-cde
Required in path
string

Identification of the aspsp

{
    "default": ""
}
payment-product
Required in path
string

Type of payment

{
    "default": "sepa-credit-transfers",
    "enum": [
        "sepa-credit-transfers",
        "cross-border-credit-transfers",
        "instant-sepa-credit-transfers",
        "target-2-payments",
        "sdcl-sepa-credit-transfers",
        "urgent-sepa-credit-transfers"
    ]
}
bulk-payment-id
Required in path
string

Identification of the bulk payment

{
    "default": ""
}
TPP-Transaction-ID
Required in header
string / uuid

ID of the transaction as determined by the initiating party.

{
    "default": ""
}
Signature
Required in header
string

A signature of the request by the TPP on application level. This might be mandated by ASPSP.

{
    "default": ""
}
TPP-Certificate
Required in header
string

The certificate used for signing the request, in base64 encoding. Shall be contained if the signature is used.

{
    "default": ""
}
TPP-Request-ID
Required in header
string / uuid

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

{
    "default": ""
}
Date
Required in header
string / date-time

Request date

{
    "pattern": "yyyy-MM-dd'T'hh:MM:ss.SSS"
}
Accept
Optional in header
string
application/json
200

OK

BulkPaymentStatusResponseResource
400

Bad Request.

ErrorMessageWithStatus
401

Unauthorized.

ErrorMessageWithStatus
403

Forbidden.

ErrorMessageWithStatus
404

Not Found.

ErrorMessageWithStatus
405

Method Not Allowed.

ErrorMessageWithStatus
406

Not Acceptable.

ErrorMessageWithStatus
408

Request Timeout.

ErrorMessageWithStatus
415

Unsupported Media Type.

ErrorMessageWithStatus
429

Too Many Requests.

ErrorMessageWithStatus
500

Internal Server Error.

ErrorMessageWithStatus
503

Service Unavailable.

ErrorMessageWithStatus
504

Gatewaty Timeout.

ErrorMessageWithStatus
Example Request
curl --request GET \
  --url https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID/status \
  --header 'Date: REPLACE_THIS_VALUE' \
  --header 'Signature: REPLACE_THIS_VALUE' \
  --header 'TPP-Certificate: REPLACE_THIS_VALUE' \
  --header 'TPP-Request-ID: REPLACE_THIS_VALUE' \
  --header 'TPP-Transaction-ID: REPLACE_THIS_VALUE' \
  --header 'X-IBM-Client-Id: REPLACE_THIS_KEY' \
  --header 'accept: application/json'
require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID/status")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Get.new(url)
request["X-IBM-Client-Id"] = 'REPLACE_THIS_KEY'
request["TPP-Transaction-ID"] = 'REPLACE_THIS_VALUE'
request["Signature"] = 'REPLACE_THIS_VALUE'
request["TPP-Certificate"] = 'REPLACE_THIS_VALUE'
request["TPP-Request-ID"] = 'REPLACE_THIS_VALUE'
request["Date"] = 'REPLACE_THIS_VALUE'
request["accept"] = 'application/json'

response = http.request(request)
puts response.read_body
import http.client

conn = http.client.HTTPSConnection("site1.sibsapimarket.com:8445")

headers = {
    'X-IBM-Client-Id': "REPLACE_THIS_KEY",
    'TPP-Transaction-ID': "REPLACE_THIS_VALUE",
    'Signature': "REPLACE_THIS_VALUE",
    'TPP-Certificate': "REPLACE_THIS_VALUE",
    'TPP-Request-ID': "REPLACE_THIS_VALUE",
    'Date': "REPLACE_THIS_VALUE",
    'accept': "application/json"
    }

conn.request("GET", "/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID/status", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "8445",
  CURLOPT_URL => "https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID/status",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Date: REPLACE_THIS_VALUE",
    "Signature: REPLACE_THIS_VALUE",
    "TPP-Certificate: REPLACE_THIS_VALUE",
    "TPP-Request-ID: REPLACE_THIS_VALUE",
    "TPP-Transaction-ID: REPLACE_THIS_VALUE",
    "X-IBM-Client-Id: REPLACE_THIS_KEY",
    "accept: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID/status")
  .get()
  .addHeader("X-IBM-Client-Id", "REPLACE_THIS_KEY")
  .addHeader("TPP-Transaction-ID", "REPLACE_THIS_VALUE")
  .addHeader("Signature", "REPLACE_THIS_VALUE")
  .addHeader("TPP-Certificate", "REPLACE_THIS_VALUE")
  .addHeader("TPP-Request-ID", "REPLACE_THIS_VALUE")
  .addHeader("Date", "REPLACE_THIS_VALUE")
  .addHeader("accept", "application/json")
  .build();

Response response = client.newCall(request).execute();
const request = require('request');

const options = {
  method: 'GET',
  url: 'https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID/status',
  headers: {
    'X-IBM-Client-Id': 'REPLACE_THIS_KEY',
    'TPP-Transaction-ID': 'REPLACE_THIS_VALUE',
    Signature: 'REPLACE_THIS_VALUE',
    'TPP-Certificate': 'REPLACE_THIS_VALUE',
    'TPP-Request-ID': 'REPLACE_THIS_VALUE',
    Date: 'REPLACE_THIS_VALUE',
    accept: 'application/json'
  }
};

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID/status"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-IBM-Client-Id", "REPLACE_THIS_KEY")
	req.Header.Add("TPP-Transaction-ID", "REPLACE_THIS_VALUE")
	req.Header.Add("Signature", "REPLACE_THIS_VALUE")
	req.Header.Add("TPP-Certificate", "REPLACE_THIS_VALUE")
	req.Header.Add("TPP-Request-ID", "REPLACE_THIS_VALUE")
	req.Header.Add("Date", "REPLACE_THIS_VALUE")
	req.Header.Add("accept", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
import Foundation

let headers = [
  "X-IBM-Client-Id": "REPLACE_THIS_KEY",
  "TPP-Transaction-ID": "REPLACE_THIS_VALUE",
  "Signature": "REPLACE_THIS_VALUE",
  "TPP-Certificate": "REPLACE_THIS_VALUE",
  "TPP-Request-ID": "REPLACE_THIS_VALUE",
  "Date": "REPLACE_THIS_VALUE",
  "accept": "application/json"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/REPLACE_ASPSP-CDE/v1-0-3/bulk-payments/sepa-credit-transfers/REPLACE_BULK-PAYMENT-ID/status")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
Example Response
GET https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/{aspsp-cde}/v1-0-3/bulk-payments/{payment-product}/{bulk-payment-id}/status
{
  "transactionStatus": "RJCT"
}
Try this operation
https://site1.sibsapimarket.com:8445/sibs/apimarket-sb/{aspsp-cde}/v1-0-3/bulk-payments/{payment-product}/{bulk-payment-id}/status
Login to test this API.
accept
TPP-Transaction-ID
Signature
TPP-Certificate
TPP-Request-ID
Date
aspsp-cde
payment-product
bulk-payment-id

Definitions

Identifier of the addressed account.

{
    "type": "object",
    "properties": {
        "iban": {
            "description": "This data element is used in a mutually exclusive way with BBAN.",
            "type": "string",
            "pattern": "^[A-Z]{2,2}[0-9]{2,2}[a-zA-Z0-9]{1,30}$",
            "default": "PT000"
        },
        "bban": {
            "description": "This data element is used for payment accounts which have no IBAN.",
            "type": "string",
            "default": "1",
            "pattern": "^[a-zA-Z0-9]{1,30}$"
        },
        "pan": {
            "description": "Reserved for future use. Primary Account Number (PAN) of a card, can be tokenised by the ASPSP due to PCI DSS requirements.",
            "type": "string",
            "maxLength": 35,
            "default": ""
        },
        "maskedPan": {
            "description": "Reserved for future use. Primary Account Number (PAN) of a card in a masked form.",
            "type": "string",
            "maxLength": 35,
            "default": ""
        },
        "msisdn": {
            "description": "Reserved for future use. An alias to access a payment account via a registered mobile phone number",
            "type": "string",
            "maxLength": 35,
            "default": ""
        },
        "currency": {
            "description": "ISO 4217 Alpha 3 currency code.",
            "type": "string",
            "pattern": "^[A-Z]{3,3}$"
        }
    },
    "additionalProperties": false
}

Address

{
    "type": "object",
    "required": [
        "country"
    ],
    "properties": {
        "street": {
            "description": "Street",
            "type": "string",
            "maxLength": 70,
            "default": ""
        },
        "buildingNumber": {
            "description": "Building Number",
            "type": "string",
            "default": ""
        },
        "city": {
            "description": "City",
            "type": "string",
            "default": ""
        },
        "postalCode": {
            "description": "Postal Code",
            "type": "string",
            "default": ""
        },
        "country": {
            "description": "Country",
            "type": "string",
            "default": ""
        }
    },
    "additionalProperties": false
}

Amount

{
    "type": "object",
    "required": [
        "currency",
        "content"
    ],
    "properties": {
        "currency": {
            "description": "ISO 4217 currency code\n",
            "type": "string",
            "pattern": "^[A-Z]{3,3}$",
            "default": "EUR"
        },
        "content": {
            "description": "The amount given with fractional digits, where fractions must be compliant to the currency definition.\n\nThe decimal separator is a dot.\n",
            "type": "string",
            "pattern": "^\\-{0,1}[0-9]{1,9}(\\.[0-9]{0,2}){0,1}$",
            "default": "0"
        }
    },
    "additionalProperties": false
}

Array of Authentication object

{
    "type": "array",
    "items": {
        "$ref": "#/definitions/Authentication",
        "description": "Authentication Data"
    },
    "additionalProperties": false
}

Authentication Data

{
    "type": "object",
    "required": [
        "authenticationType",
        "authenticationMethodId"
    ],
    "properties": {
        "authenticationType": {
            "description": "Type of the authentication method.",
            "$ref": "#/definitions/AuthenticationType"
        },
        "authenticationVersion": {
            "description": "Depending on the authenticationType.  This version can be used by differentiating authentication tools used within performing OTP generation in the same authentication type.  This version can be referred to in the ASPSP’s documentation.\n",
            "type": "string",
            "default": ""
        },
        "authenticationMethodId": {
            "description": "An identification provided by the ASPSP for the later identification of the authentication method selection.\n",
            "type": "string",
            "maxLength": 35,
            "default": ""
        },
        "name": {
            "description": "This is the name of the authentication method defined by the PSU in the Online Banking frontend of the ASPSP.  Alternatively this could be a description provided by the ASPSP like “SMS OTP on phone +49160 xxxxx 28”. This name shall be used by the TPP when presenting a list of authentication methods to the PSU, if available.\n",
            "type": "string",
            "default": ""
        },
        "explanation": {
            "description": "detailed information about the sca method for the PSU.\n",
            "type": "string",
            "default": ""
        }
    },
    "additionalProperties": false
}

authentication types:

  • SMS_OTP - An SCA method, where an OTP linked to the transaction to be authorised is sent to the PSU through a SMS channel.

  • CHIP_OTP - An SCA method, where an OTP is generated by a chip card, e.g. an TOP derived from an EMV cryptogram. To contact the card, the PSU normally needs a (handheld) device. With this device, the PSU either reads the challenging data through a visual interface like flickering or the PSU types in the challenge through the device key pad. The device then derives an OTP from the challenge data and displays the OTP to the PSU.

  • PHOTO_OTP - An SCA method, where the challenge is a QR code or similar encoded visual data which can be read in by a consumer device or specific mobile app. The device resp. the specific app than derives an OTP from the visual challenge data and displays the OTP to the PSU.

  • PUSH_OTP - An OTP is pushed to a dedicated authentication APP and displayed to the PSU.

{
    "type": "string",
    "enum": [
        "SMS_OTP",
        "CHIP_OTP",
        "PHOTO_OTP",
        "PUSH_OTP"
    ],
    "default": "SMS_OTP",
    "additionalProperties": false
}

Payment initiation object

{
    "type": "object",
    "properties": {
        "instructedAmount": {
            "$ref": "#/definitions/Amount"
        },
        "endToEndIdentification": {
            "description": "Unique identification as assigned by the sending party to unambiguously identify this payment.",
            "type": "string",
            "maxLength": 35,
            "default": ""
        },
        "creditorAccount": {
            "$ref": "#/definitions/AccountReference",
            "description": ""
        },
        "creditorAgent": {
            "description": "BICFI",
            "type": "string",
            "pattern": "^[A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}$",
            "default": "ABCDEFABC0A"
        },
        "creditorName": {
            "description": "Name of the creditor if a “Debited” transaction",
            "type": "string",
            "maxLength": 70,
            "minLength": 1,
            "default": "a"
        },
        "creditorAddress": {
            "$ref": "#/definitions/Address",
            "description": ""
        },
        "creditorClearingCode": {
            "type": "string",
            "description": "Clearing Code of the Creditor Finantial Institution."
        },
        "remittanceInformationUnstructured": {
            "description": "",
            "type": "string",
            "maxLength": 140,
            "default": ""
        },
        "purposeCode": {
            "type": "string",
            "description": "Specifies the external purpose code in the format of character string with a maximum length of 4 characters. The list of valid codes is an external code list published.",
            "maxLength": 4
        },
        "chargeBearer": {
            "$ref": "#/definitions/ChargeBearer",
            "description": "Specifies which party/parties will bear the charges associated with the processing of the payment transaction."
        },
        "creditorAgentName": {
            "type": "string",
            "description": "Name of the creditor's agent"
        },
        "creditorAgentAddress": {
            "$ref": "#/definitions/Address",
            "description": "Address of the creditors agent"
        }
    },
    "additionalProperties": false,
    "required": [
        "creditorAccount",
        "creditorName",
        "creditorAddress",
        "instructedAmount"
    ]
}

Array of Bulk Entries object

{
    "type": "array",
    "maxItems": 20000,
    "minItems": 1,
    "items": {
        "$ref": "#/definitions/BulkEntry"
    },
    "additionalProperties": false
}

Bulk Payment initiation object

{
    "type": "object",
    "properties": {
        "instructedAmount": {
            "$ref": "#/definitions/Amount"
        },
        "endToEndIdentification": {
            "description": "Unique identification as assigned by the sending party to unambiguously identify this payment.",
            "type": "string",
            "maxLength": 35,
            "default": ""
        },
        "creditorAccount": {
            "$ref": "#/definitions/AccountReference",
            "description": ""
        },
        "creditorAgent": {
            "description": "BICFI",
            "type": "string",
            "pattern": "^[A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}$",
            "default": "ABCDEFABC0A"
        },
        "creditorName": {
            "description": "Name of the creditor if a “Debited” transaction",
            "type": "string",
            "maxLength": 70,
            "minLength": 1,
            "default": "a"
        },
        "creditorAddress": {
            "$ref": "#/definitions/Address",
            "description": ""
        },
        "creditorClearingCode": {
            "type": "string",
            "maxLength": 35,
            "description": "Clearing Code of the Creditor Finantial Institution."
        },
        "remittanceInformationUnstructured": {
            "description": "",
            "type": "string",
            "maxLength": 140,
            "default": ""
        },
        "purposeCode": {
            "type": "string",
            "description": "Specifies the external purpose code in the format of character string with a maximum length of 4 characters. The list of valid codes is an external code list published.",
            "maxLength": 4
        },
        "chargeBearer": {
            "$ref": "#/definitions/ChargeBearer",
            "description": "Specifies which party/parties will bear the charges associated with the processing of the payment transaction."
        },
        "creditorAgentName": {
            "type": "string",
            "maxLength": 140,
            "description": "Name of the creditor's agent"
        },
        "creditorAgentAddress": {
            "$ref": "#/definitions/Address",
            "description": "Address of the creditors agent"
        },
        "paymentStatus": {
            "$ref": "#/definitions/TransactionStatusType",
            "description": "In case where the Payment Initiation Request was JSON encoded as defined in Section 5.3.1, the status is returned in this JSON based encoding."
        },
        "requestedExecutionDate": {
            "type": "string",
            "description": "Indicates the acceptance of future dated payments (yyyy-MM-dd) by issuing an ASPSP.",
            "format": "date",
            "default": "9999-12-31"
        }
    },
    "additionalProperties": false,
    "required": [
        "creditorAccount",
        "creditorName",
        "creditorAddress",
        "instructedAmount",
        "paymentStatus"
    ]
}

Array of Bulk Entries object

{
    "type": "array",
    "items": {
        "$ref": "#/definitions/BulkEntryWStatus"
    },
    "additionalProperties": false
}

Requested Authentication Data

{
    "type": "object",
    "properties": {
        "image": {
            "description": "PNG data (max. 512 kilobyte) to be displayed to the PSU, Base64 encoding , cp. [RFC 4648]. This attribute is used only, when PHOTO_OTP or CHIP_OTP is the selected SCA method.\n",
            "type": "string",
            "format": "byte",
            "default": ""
        },
        "data": {
            "description": "String challenge data",
            "type": "string",
            "default": ""
        },
        "imageLink": {
            "description": "A link where the ASPSP will provides the challenge image for the TPP.",
            "type": "string",
            "default": ""
        },
        "otpMaxLength": {
            "description": "The maximal length for the OTP to be typed in by the PSU.",
            "type": "number",
            "default": 0
        },
        "otpFormat": {
            "description": "The format type of the OTP to be typed in.",
            "type": "string",
            "enum": [
                "characters",
                "integer"
            ],
            "default": "integer"
        },
        "additionalInformation": {
            "description": "Additional explanation for the PSU to explain e.g. fallback mechanism for the chosen SCA method. The TPP is obliged to show this to the PSU.",
            "type": "string",
            "default": ""
        }
    },
    "additionalProperties": false
}

TBD

{
    "type": "string",
    "enum": [
        "DEBT",
        "CRED",
        "SHAR",
        "SLEV"
    ],
    "default": "SHAR",
    "additionalProperties": false
}

Error Information.

{
    "type": "object",
    "properties": {
        "tppMessages": {
            "$ref": "#/definitions/TppMessageArray",
            "description": "Messages to the TPP on operational issues."
        }
    },
    "additionalProperties": false
}

Error and status Information.

{
    "type": "object",
    "properties": {
        "transactionStatus": {
            "$ref": "#/definitions/TransactionStatusType",
            "description": "The transaction status is filled with codes of the ISO 20022 corresponding element."
        },
        "tppMessages": {
            "$ref": "#/definitions/TppMessageArray",
            "description": "Messages to the TPP on operational issues."
        }
    },
    "additionalProperties": false
}

Message error codes.

{
    "type": "string",
    "enum": [
        "SERVICE_BLOCKED",
        "CORPORATE_ID_IVALID",
        "CONSENT_UNKNOWN",
        "CONSENT_INVALID",
        "CONSENT_EXPIRED",
        "RESOURCE_UNIKNOWN",
        "RESOURCE_EXPIRED",
        "TIMESTAMP_INVALID",
        "PERIOD_INVALID",
        "SCA_METHOD_UNKKNOWN",
        "TRANSACTION_ID_INVALID",
        "PRODUCT_INVALID",
        "PRODUCT_UNKNOWN",
        "PAYMENT_FAILED",
        "REQUIRED_KID_MISSING",
        "SESSIONS_NOT_SUPPORTED",
        "ACCESS_EXCEEDED",
        "REQUESTED_FORMATS_INVALID",
        "CARD_INVALID",
        "NO_PIIS_ACTIVATION"
    ],
    "default": "CONSENT_INVALID",
    "additionalProperties": false
}

Cancels a bulk payment initiation response to TPP.

{
    "properties": {
        "transactionStatus": {
            "$ref": "#/definitions/TransactionStatusBulkType",
            "description": "In case where the Cancel Payment Initiation Request was JSON encoded as defined in Section 5.3.1, the status is returned in this JSON based encoding."
        },
        "_links": {
            "$ref": "#/definitions/PaymentLink",
            "description": "A list of hyperlinks to be recognised by the TPP. The actual hyperlinks used in the response depend on the dynamical decisions of the ASPSP when processing the request. Remark: All links can be relative or full links, to be decided by the ASPSP. Type of links admitted in this response, (further links might be added for ASPSP defined extensions): “redirect”: In case of an SCA Redirect Approach, the ASPSP is transmitting the link to which to redirect the PSU browser. “updatePsuIdentification”: The link to the payment initiation resource, which needs to be updated by the PSU identification. This might be used in an embedded, redirect or decoupled SCA Approach, where the PSU ID was missing in the first request. “updatePsuAuthentication”: The link to the payment initiation resource, which needs to be updated by a PSU password and eventually the PSU identification if not delivered yet. This is used in case of the Embedded or Decoupled SCA approach. “selectAuthenticationMethod” : This is a link to a resource, where the TPP can select the applicable strong customer authentication methods for the PSU, if there were several available authentication methods. This link contained under exactly the same conditions as the data element “authenticationMethods”, see above. “authoriseTransaction” : The link to the payment initiation resource, where the “Payment Authorisation Request” is sent to. This is the link to the resource which will authorise the payment by checking the SCA authentication data within the Embedded SCA approach."
        },
        "psuMessage": {
            "type": "string",
            "description": "Text to be displayed to the PSU."
        },
        "tppMessage": {
            "$ref": "#/definitions/TppMessageArray",
            "description": "Messages to the TPP on operational issues."
        },
        "transactionFees": {
            "description": "Can be used by the ASPSP to transport transaction fees relevant for the underlying payments.",
            "$ref": "#/definitions/Amount"
        },
        "transactionFeeIndicator": {
            "type": "boolean",
            "description": "If equals “true”, the transaction will involve specific transaction cost as shown by the ASPSP in their public price list or as agreed between ASPSP and PSU. If equals “false”, the transaction will not involve additional specific transaction costs to the PSU."
        },
        "scaMethods": {
            "description": "This data element might be contained, if SCA is required and if the PSU has a choice between different authentication methods. Depending on the risk management of the ASPSP this choice might be offered before or after the PSU has been identified with the first relevant factor, or if an access token is transported. If this data element is contained, then there is also an hyperlink of type “selectAuthenticationMethods” contained in the response body. These methods shall be presented towards the PSU for selection by the TPP.",
            "$ref": "#/definitions/AuthenticationArray"
        }
    },
    "additionalProperties": false,
    "required": [
        "transactionStatus"
    ]
}

Returns the content of a bulk payment initiation object.

{
    "type": "object",
    "required": [
        "transactionStatus",
        "bulkPaymentId"
    ],
    "properties": {
        "transactionStatus": {
            "$ref": "#/definitions/TransactionStatusBulkType",
            "description": "Status"
        },
        "bulkPaymentId": {
            "description": "Resource identification of the generated bulk payment initiation resource.",
            "type": "string",
            "default": ""
        },
        "debtorAccount": {
            "$ref": "#/definitions/AccountReference",
            "description": "Debtor account"
        },
        "debtorName": {
            "description": "Payment's debtor name.",
            "maxLength": 70,
            "type": "string"
        },
        "batchBookingPreferred": {
            "type": "boolean",
            "description": "If this element equals true, the PSU prefers only one booking entry. If this element equals false, the PSU prefers individual booking of all contained individual transactions. The ASPSP will follow this preference according to contracts agreed on with the PSU."
        },
        "paymentInformationId": {
            "description": "Unique identification as assigned by the sending party to unambiguously identify this bulk payment.",
            "maxLength": 35,
            "type": "string"
        },
        "requestedExecutionDate": {
            "type": "string",
            "format": "date",
            "description": "Indicates the acceptance of future dated payments (yyyy-MM-dd) by issuing an ASPSP.",
            "default": "9999-12-31"
        },
        "transactionFees": {
            "$ref": "#/definitions/Amount",
            "description": "Can be used by the ASPSP to transport transaction fees relevant for the underlying payments."
        },
        "transactionFeeIndicator": {
            "type": "boolean",
            "description": "\"If equals “true”, the transaction will involve specific transaction cost as shown by the ASPSP in their public price list or as agreed between ASPSP and PSU. If equals “false”, the transaction will not involve additional specific transaction costs to the PSU.\""
        },
        "payments": {
            "$ref": "#/definitions/BulkEntryArrayWStatus",
            "description": "Array of Payment Initiations"
        }
    },
    "additionalProperties": false
}

A list of hyperlinks to be recognized by the TPP.

{
    "properties": {
        "redirect": {
            "description": "A link to an ASPSP site where SCA is performed within the Redirect SCA approach.\n",
            "type": "string",
            "default": ""
        },
        "updatePsuIdentification": {
            "description": "The link to the payment initiation or account information resource, which needs to be updated by the PSU NextGenPSD2 XS2A Framework – Implementation Guidelines Complex Data Types and Code Lists Published by the Berlin Group under Creative Commons Attribution-NoDerivatives 4.0 International Public License Page 133(ref. License Notice for full license conditions) Attribute Type Condition Description identification if not delivered yet.\n",
            "type": "string",
            "default": ""
        },
        "updatePsuAuthentication": {
            "description": "The link to the payment initiation or account information resource, which needs to be updated by a PSU password and eventually the PSU identification if not delivered yet.\n",
            "type": "string",
            "default": ""
        },
        "selectAuthenticationMethod": {
            "description": "This is a link to a resource, where the TPP can select the applicable second factor authentication methods for the PSU, if there were several available authentication methods.\n",
            "type": "string",
            "default": ""
        },
        "authoriseTransaction": {
            "description": "The link to the payment initiation or consent resource, where the “Transaction Authorisation”Request” is sent to.\nThis is the link to the resource which will authorise the payment or the consent by checking the SCA authentication data within the Embedded SCA approach.\n",
            "type": "string",
            "default": ""
        },
        "self": {
            "description": "The link to the payment initiation resource created by the request itself. This link can be used later to retrieve the transaction status of the payment initiation.\n",
            "type": "string",
            "default": ""
        },
        "updateProprietaryData": {
            "description": "The link to the payment initiation or account information resource, which needs to be updated by the proprietary data.\n",
            "type": "string",
            "default": ""
        },
        "status": {
            "description": "Stgatus of the resource.",
            "type": "string",
            "default": ""
        }
    },
    "additionalProperties": false
}

Creates a bulk payment initiation request at the ASPSP.

{
    "type": "object",
    "properties": {
        "debtorAccount": {
            "$ref": "#/definitions/AccountReference",
            "description": ""
        },
        "debtorName": {
            "description": "Payment's debtor name.",
            "maxLength": 70,
            "type": "string"
        },
        "batchBookingPreferred": {
            "type": "boolean",
            "description": "If this element equals true, the PSU prefers only one booking entry. If this element equals false, the PSU prefers individual booking of all contained individual transactions. The ASPSP will follow this preference according to contracts agreed on with the PSU."
        },
        "paymentInformationId": {
            "description": "Unique identification as assigned by the sending party to unambiguously identify this bulk payment.",
            "maxLength": 35,
            "minLength": 1,
            "type": "string"
        },
        "requestedExecutionDate": {
            "type": "string",
            "format": "date",
            "description": "Indicates the acceptance of future dated payments by issuing an ASPSP."
        },
        "payments": {
            "description": "Array of Payment Initiations",
            "$ref": "#/definitions/BulkEntryArray"
        }
    },
    "additionalProperties": false,
    "required": [
        "payments",
        "paymentInformationId"
    ]
}

Creates a bulk payment initiation response to TPP.

{
    "type": "object",
    "required": [
        "transactionStatus",
        "bulkPaymentId",
        "_links"
    ],
    "properties": {
        "transactionStatus": {
            "$ref": "#/definitions/TransactionStatusBulkType",
            "description": "The transaction status is filled with codes of the ISO 20022 data table."
        },
        "bulkPaymentId": {
            "description": "Resource identification of the generated bulk payment initiation resource.\n",
            "type": "string",
            "default": ""
        },
        "transactionFees": {
            "$ref": "#/definitions/Amount",
            "description": "Can be used by the ASPSP to transport transaction fees relevant for the underlying payments."
        },
        "transactionFeeIndicator": {
            "description": "If equals \"true\" the transaction will involve specific transaction cost as shown by the ASPSP in their public price list or as agreed between ASPSP and PSU.\n\nIf equals \"false\" the transaction will not involve additional specific transaction costs to the PSU.\n",
            "type": "boolean",
            "default": false
        },
        "scaMethods": {
            "$ref": "#/definitions/AuthenticationArray",
            "description": "This data element might be contained, if SCA is required and if the PSU has a choice between different authentication methods. Depending on the risk management of the ASPSP this choice might be offered before or after the PSU has been identified with the first relevant factor, or if an access token is transported. If this data element is contained, then there is also an hyperlink of type “selectAuthenticationMethods” contained in the response body.\nThese methods shall be presented towards the PSU for selection by the TPP.\n"
        },
        "chosenScaMethod": {
            "$ref": "#/definitions/Authentication",
            "description": "This data element is only contained in the response if the APSPS has chosen the Embedded SCA Approach, if the PSU is already identified e.g. with the first relevant factor or alternatively an access token, if SCA is required and if the authentication method is implicitly selected.\n"
        },
        "challengeData": {
            "$ref": "#/definitions/Challenge",
            "description": "It is contained in addition to the data element chosenScaMethod if challenge data is needed for SCA.\nIn rare cases this attribute is also used in the context of the psuAuthentication link.\n"
        },
        "_links": {
            "$ref": "#/definitions/PaymentLink",
            "description": "\"A list of hyperlinks to be recognised by the TPP. The actual hyperlinks used in the response depend on the dynamical decisions of the ASPSP when processing the request. Remark: All links can be relative or full links, to be decided by the ASPSP. Type of links admitted in this response, (further links might be added for ASPSP defined extensions): “redirect”: In case of an SCA Redirect Approach, the ASPSP is transmitting the link to which to redirect the PSU browser. “oAuth”: In case of a SCA OAuth2 Approach, the ASPSP is transmitting the URI where the configuration of the Authorisation Server can be retrieved. The configuration follows the OAuth 2.0 Authorisation Server Metadata specification. “updatePsuIdentification”: The link to the payment initiation resource, which needs to be updated by the PSU identification. This might be used in an embedded, redirect or decoupled SCA Approach, where the PSU ID was missing in the first request. “updatePsuAuthentication”: The link to the payment initiation resource, which needs to be updated by a PSU password and eventually the PSU identification if not delivered yet. This is used in case of the Embedded or Decoupled SCA approach. “selectAuthenticationMethod” : This is a link to a resource, where the TPP can select the applicable strong customer authentication methods for the PSU, if there were several available authentication methods. This link contained under exactly the same conditions as the data element “authenticationMethods”, see above. “authoriseTransaction” : The link to the payment initiation resource, where the “Payment Authorisation Request” is sent to. This is the link to the resource which will authorise the payment by checking the SCA authentication data within the Embedded SCA approach. “self” : The link to the payment initiation resource created by this request. This link can be used to retrieve the resource data. “status”: The link to retrieve the transaction status of the payment initiation.\""
        },
        "psuMessage": {
            "description": "Text to be displayed to the PSU.",
            "type": "string",
            "default": ""
        },
        "tppMessages": {
            "$ref": "#/definitions/TppMessageArray",
            "description": "Messages to the TPP on operational issues."
        }
    },
    "additionalProperties": false
}

Informs TPP about status of a bulk payment initiation.

{
    "type": "object",
    "required": [
        "transactionStatus"
    ],
    "properties": {
        "transactionStatus": {
            "$ref": "#/definitions/TransactionStatusBulkType",
            "description": "In case where the Payment Initiation Request was JSON encoded as defined in Section 5.3.1, the status is returned in this JSON based encoding."
        }
    },
    "additionalProperties": false
}

Updates information related to a previous bulk payment initiation in order to obtain PSUId credentials.

{
    "type": "object",
    "properties": {
        "psuData": {
            "$ref": "#/definitions/PSUData",
            "description": "Include all credentials related data (e.g., user, password and additional data accordingly with ASPSP requests)"
        },
        "scaAuthenticationData": {
            "description": "SCA authentication data, depending on the chosen authentication method.\n\nif the data is binary, then it is base64 encoded.",
            "type": "string",
            "default": ""
        },
        "authenticationMethodId": {
            "description": "The authentication method ID as provided by the ASPSP. This property is mandatory in a Select Authentication Method.",
            "type": "string",
            "default": ""
        }
    },
    "additionalProperties": false
}

Sends an update information related to a previous bulk payment initiation to TPP.

{
    "type": "object",
    "required": [
        "transactionStatus",
        "_links"
    ],
    "properties": {
        "transactionStatus": {
            "$ref": "#/definitions/TransactionStatusBulkType",
            "description": "This is the “authentication status” of the consent."
        },
        "psuMessage": {
            "description": "Include all credentiText to be displayed to the PSUals related data (e.g., user, password and additional data accordingly with ASPSP requests)",
            "type": "string",
            "default": ""
        },
        "tppMessages": {
            "$ref": "#/definitions/TppMessageArray",
            "description": "Messages to the TPP on operational issues."
        },
        "scaMethods": {
            "$ref": "#/definitions/AuthenticationArray",
            "description": "This data element might be contained, if SCA is required and if the PSU has a choice between different authentication methods. Depending on the risk management of the ASPSP this choice might be offered before or after the PSU has been identified with the first relevant factor, or if an access token is transported. If this data element is contained, then there is also an hyperlink of type \"startAuthorisationWith AuthenticationMethodSelection\" contained in the response body. These methods shall be presented towards the PSU for selection by the TPP."
        },
        "chosenScaMethod": {
            "$ref": "#/definitions/Authentication",
            "description": "If the ASPSP has chosen the Embedded SCA Approach, if the PSU is already identified e.g. with the first relevant factor or alternatively an access token, if SCA is required and if the authentication method is implicitly selected."
        },
        "challengeData": {
            "$ref": "#/definitions/Challenge",
            "description": "It is contained in addition to the data element chosenScaMethod if challenge data is needed for SCA. In rare cases this attribute is also used in the context of the psuAuthentication link."
        },
        "_links": {
            "$ref": "#/definitions/PaymentLink",
            "description": "A list of hyperlinks to be recognised by the TPP. The actual hyperlinks used in the response depend on the dynamical decisions of the ASPSP when processing the request. Remark: All links can be relative or full links, to be decided by the ASPSP. Type of links admitted in this response, (further links might be added for ASPSP defined extensions): “redirect”: In case of an SCA Redirect Approach, the ASPSP is transmitting the link to which to redirect the PSU browser. “oAuth”: In case of a SCA OAuth2 Approach, the ASPSP is transmitting the URI where the configuration of the Authorisation Server can be retrieved. The configuration follows the OAuth 2.0 Authorisation Server Metadata specification. “updatePsuIdentification”: The link to the payment initiation resource, which needs to be updated by the PSU identification. This might be used in an embedded, redirect or decoupled SCA Approach, where the PSU ID was missing in the first request. “updatePsuAuthentication”: The link to the payment initiation resource, which needs to be updated by a PSU password and eventually the PSU identification if not delivered yet. This is used in case of the Embedded or Decoupled SCA approach. “selectAuthenticationMethod” : This is a link to a resource, where the TPP can select the applicable strong customer authentication methods for the PSU, if there were several available authentication methods. This link contained under exactly the same conditions as the data element “authenticationMethods”, see above. “authoriseTransaction” : The link to the payment initiation resource, where the “Payment Authorisation Request” is sent to. This is the link to the resource which will authorise the payment by checking the SCA authentication data within the Embedded SCA approach. “self” : The link to the payment initiation resource created by this request. This link can be used to retrieve the resource data. “status”: The link to retrieve the transaction status of the payment initiation."
        }
    },
    "additionalProperties": false
}

The password or encryptedPassword subfield is used, depending on encryption requirements of the ASPSP as indicated in the corresponding hyperlink contained in the last response message of the ASPSP.

{
    "type": "object",
    "properties": {
        "password": {
            "description": "PSU Password.",
            "type": "string",
            "minLength": 1,
            "default": "1"
        }
    },
    "additionalProperties": false
}

Transports additional error information.

{
    "required": [
        "category",
        "code"
    ],
    "properties": {
        "category": {
            "type": "string",
            "default": "",
            "description": "Category of the error. Only \"ERROR\" or \"WARNING\" permitted."
        },
        "code": {
            "$ref": "#/definitions/MessageCode",
            "description": "Message error code."
        },
        "path": {
            "type": "string",
            "default": "",
            "description": "Path of the element of the request message which provoked this error message."
        },
        "text": {
            "type": "string",
            "maxLength": 512,
            "default": "",
            "description": "Additional explaining text."
        }
    },
    "additionalProperties": false
}

Messages to the TPP on operational issues.

{
    "type": "array",
    "items": {
        "$ref": "#/definitions/TppMessage",
        "description": "Transports additional error information."
    },
    "additionalProperties": false
}

ISO20022: The transaction status is filled with value of the ISO20022 data table. RCVD : RECEIVED PDNG : PENDING PATC : PARTIALLY ACCEPTED TECHNICAL CORRECT ACTC : ACCEPTED TECHNICAL VALIDATION ACFC : ACCEPTED FUNDS CHECKED ACWC : ACCEPTED WITH CHANGE ACWP : ACCEPTED WITHOUT POSTING ACSP : ACCEPTED SETTLEMENT IN PROCESS ACSC : ACCEPTED SETTLEMENT COMPLETED ACCC : ACCEPTED SETTLEMENT COMPLETED CREDITOR CANC : CANCELED RJCT : REJECTED

{
    "type": "string",
    "enum": [
        "RCVD",
        "PDNG",
        "PATC",
        "ACTC",
        "ACFC",
        "ACWC",
        "ACWP",
        "ACSP",
        "ACSC",
        "ACCC",
        "CANC",
        "RJCT"
    ],
    "default": "RJCT",
    "additionalProperties": false
}

ISO20022: The transaction status is filled with value of the ISO20022 data table. RCVD : RECEIVED PDNG : PENDING PATC : PARTIALLY ACCEPTED TECHNICAL CORRECT PART : PARTIALLY ACCEPTED ACTC : ACCEPTED TECHNICAL VALIDATION ACFC : ACCEPTED FUNDS CHECKED ACSP : ACCEPTED SETTLEMENT IN PROCESS ACSC : ACCEPTED SETTLEMENT COMPLETED ACCC : ACCEPTED SETTLEMENT COMPLETED CREDITOR CANC : CANCELED RJCT : REJECTED

{
    "type": "string",
    "enum": [
        "RCVD",
        "PDNG",
        "PATC",
        "PART",
        "ACTC",
        "ACFC",
        "ACSP",
        "ACSC",
        "ACCC",
        "CANC",
        "RJCT"
    ],
    "default": "RJCT",
    "additionalProperties": false
}