v1

latestSwagger 2.02026-07-14129254.9 KB

SEPA Payments Consent

Request consent initiation via redirect

Request a SEPA credit transfer consent on behalf of the PSU via a URL redirect to the ASPSP.

post/payments/sepa-credit-transfers/consents

Request body

Example request

{
  "payments": {
    "categoryPurpose": "CASH",
    "creditorAccount": {
      "iban": "PL45222222222222222222222222"
    },
    "creditorAddress": {
      "buildingNumber": "15",
      "city": "City",
      "country": "CC",
      "countrySubDivision": "Division",
      "postalCode": "PostCode",
      "street": "Street"
    },
    "creditorAgent": {
      "bicfi": "BARCGB22XXX"
    },
    "creditorName": "Wood bank",
    "debtorAccount": {
      "iban": "PL45222222222222222222222222"
    },
    "debtorAddress": {
      "buildingNumber": "15",
      "city": "City",
      "country": "CC",
      "countrySubDivision": "Division",
      "postalCode": "PostCode",
      "street": "Street"
    },
    "debtorAgent": {
      "bicfi": "BARCGB22XXX"
    },
    "debtorName": "NordPole PLC",
    "endToEndIdentification": "Notification",
    "instructedAmount": {
      "amount": 200,
      "currency": "EUR"
    },
    "instructionPriority": "Normal",
    "localInstrument": "SEPA",
    "remittanceInformationReference": "UniqueRef1",
    "remittanceInformationStructured": "Payment for fruits from card 543210000023456",
    "remittanceInformationUnstructured": "Payment for fruits"
  },
  "requestInfo": {
    "aspspId": "b806ae68-a45b-49d6-b25a-69fdb81dede6",
    "merchant": {
      "id": "MerchantId",
      "name": "MerchantName"
    },
    "tppRedirectURI": "https://tpp-ob.com/callback",
    "xRequestId": "123e4567-e89b-12d3-a456-426655440000"
  }
}

Response

Success

aspspSCAApproach'REDIRECT'

consentRequestIdstring

Example response

{
  "_links": {
    "scaRedirect": "https://bank1.com/sca/login"
  },
  "originalRequestInfo": {
    "xRequestId": "444e4567-e55b-12d3-a456-426655448888"
  }
}