obOpen Banking Lab
GlossarySTETBlogContact
Specification
  • 1Introduction
  • 2Business Model
  • 3Prerequisites and technical details
API reference
  • AISP
    • GETaccounts
    • GETbalances
    • GEToverdrafts
    • GETowners
    • GETtransactions
    • GETdetails
    • PUTconsents
    • GETend user identity
    • GETtrusted beneficiaries
  • PISP
    • POSTpayment requests
    • GETpayment requests
    • PUTpayment requests
    • POSTconfirmation
    • GETtransactions
  • CBPII
    • POSTfunds confirmations
    • Access
    • AccessibleAccounts
    • AccessibleTrustedBeneficiaries
    • AccountIdentification
    • AccountLinks
    • AccountListLinks
    • AccountResource
    • AmountAndCurrencyExchange
    • AmountAndCurrencyExchangeDetails
    • AmountType
    • AuthenticationApproach
    • AuthenticationApproaches
    • BalanceResource
    • BalancesLinks
    • BalanceStatus
    • BankTransactionCode
    • BatchBookingIndicator
    • BeneficiariesLinks
    • Beneficiary
    • BookingInformation
    • CategoryPurposeCode
    • ChargeBearerCode
    • Charges
    • ChargesRecord
    • ClearingSystemMemberIdentification
    • CodeAndIssuer
    • ConfirmationResource
    • ContactDetails
    • CreationDateTime
    • CreditDebitIndicator
    • CreditorReferenceInformation
    • CreditTransferTransactionLinks
    • CreditTransferTransactionResource
    • CurrencyCode
    • DateAndPlaceOfBirth
    • DocumentAdjustment
    • DocumentLineIdentification
    • EndDate
    • EndToEndId
    • EndUserIdentityLinks
    • EquivalentAmountType
    • ErrorDetail
    • ErrorModel
    • ExchangeRate
    • ExecutionRule
    • FinancialInstitutionIdentification
    • FrequencyCode
    • FundsAvailabilityInformation
    • GenericIdentification
    • GenericLink
    • HalAccounts
    • HalAuthenticationRequest
    • HalBalances
    • HalBeneficiaries
    • HalCreditTransfertTransactions
    • HalEndUserIdentity
    • HalOverdrafts
    • HalOwners
    • HalPaymentCoverageReport
    • HalPaymentRequest
    • HalTransactionDetails
    • HalTransactions
    • Identity
    • InstructionForCreditorAgent
    • IntermediaryAgent
    • LeiIdentification
    • LineDetail
    • LocalInstrumentCode
    • NamePrefixCode
    • Nonce
    • Overdraft
    • OverdraftsLinks
    • OwnersLinks
    • PartyIdentification
    • PaymentCoverageReportLinks
    • PaymentCoverageRequestResource
    • PaymentIdentification
    • PaymentInformationId
    • PaymentInformationStatusCode
    • PaymentRequestLinks
    • PaymentRequestResource
    • PaymentRequestResourceCreationLinks
    • PaymentTypeInformation
    • PercentageRate
    • Period
    • PhoneNumber
    • PostalAddress
    • PriorityCode
    • PsuStatusType
    • PurposeCode
    • ReferredDocumentInformation
    • ReferredDocumentInformations
    • RegulatoryReportingCode
    • RegulatoryReportingCodes
    • RelatedParties
    • RemittanceAmount
    • RemittanceInformation
    • RequestedExecutionDate
    • ResourceId
    • ServiceLevelCode
    • StandingOrderCharacteristics
    • StartDate
    • StatusReasonInformation
    • StructuredRemittanceInformation
    • SupplementaryData
    • TaxAmount
    • TaxCharges
    • TaxInformation
    • TaxParty
    • TaxPeriod
    • TaxRecord
    • TaxRecordDetails
    • TaxRecordPeriodCode
    • TitleAndName
    • TransactionDetailsLinks
    • TransactionIndividualStatusCode
    • TransactionLinks
    • TransactionResource
    • TransactionsLinks
    • TransactionStatus
    • TypedAmount
    • Workspace
Examples
  • 6.1PSU Context Retrieval
  • 6.2Consent Forwarding
  • 6.3PSU identification Retrieval
  • 6.4Account Owners Identities Retrieval
  • 6.5Account Balances Retrieval
  • 6.6Account Overdrafts Retrieval
  • 6.7Account Transactions Retrieval
  • 6.8Account Transaction details Retrieval
  • 6.9Trusted Beneficiaries Retrieval
  • 7.1Account Amount Coverage Check
  • 8.1Payment Request with multiple instructions having different
  • 8.2Payment Request with multiple instructions having different beneficiaries
  • 8.3Standing Orders Request
Changelog
  • Changelog
  1. Home
  2. STET 1.6.3.1
  3. Reference
  4. Resources
  5. HalPaymentRequest
Halobject

HalPaymentRequest

HYPERMEDIA structure used for returning the original Payment Request to the PISP

Fields (2)

  • paymentRequestPaymentRequestResourcerequired

    Schema: PaymentRequestResource

  • _linksPaymentRequestLinksrequired

    Schema: PaymentRequestLinks

Used in 2 endpoints

  • post/payment-requests/{paymentRequestResourceId}/confirmation
  • get/payment-requests/{paymentRequestResourceId}
PreviousHalPaymentCoverageReportResourcesNextHalTransactionDetailsResources

Source

Built from the official STET OpenAPI specification (Swagger 2.0), mirrored under CC BY 3.0 FR.

Open OpenAPI spec
Example
{
  "paymentRequest": {
    "resourceId": "MyPmtInfRscId",
    "paymentInformationId": "MyPmtInfId",
    "creationDateTime": "2020-02-19T13:56:54.758+01:00",
    "numberOfTransactions": 2,
    "initiatingParty": {
      "name": "MyPreferredPisp",
      "postalAddress": {
        "country": "FR",
        "addressLine": [
          "18 rue de la DSP2",
          "75008 PARIS"
        ]
      },
      "organisationId": {
        "identification": "12FR5",
        "schemeName": "COID",
        "issuer": "ACPR"
      }
    },
    "paymentTypeInformation": {
      "serviceLevel": "SEPA",
      "localInstrument": "INST",
      "categoryPurpose": "CASH"
    },
    "debtor": {
      "name": "MyCustomer",
      "postalAddress": {
        "country": "FR",
        "addressLine": [
          "18 rue de la DSP2",
          "75008 PARIS"
        ]
      },
      "privateId": {
        "identification": "FD37G",
        "schemeName": "BANK",
        "issuer": "BICXYYTTZZZ"
      }
    },
    "debtorAgent": {
      "bicFi": "BNKAFRPPXXX"
    },
    "chargeBearer": "SLEV",
    "paymentInformationStatus": "PDNG",
    "creditTransferTransaction": [
      {
        "paymentId": {
          "instructionId": "MyInstrId3",
          "endToEndId": "MyEndToEndId3"
        },
        "requestedExecutionDate": "2020-02-19T13:56:54.759+01:00",
        "instructedAmount": {
          "amount": 124.35,
          "currency": "EUR"
        },
        "beneficiary": {
          "creditor": {
            "name": "June Doe",
            "postalAddress": {
              "country": "FR",
              "addressLine": [
                "18 rue de la DSP2",
                "75008 PARIS"
              ]
            },
            "organisationId": {
              "identification": "12FR5",
              "schemeName": "COID",
              "issuer": "ACPR"
            },
            "privateId": {
              "identification": "852126789",
              "schemeName": "SIREN",
              "issuer": "FR"
            }
          },
          "creditorAccount": {
            "iban": "YY49QEZO90424459988701367845944910",
            "currency": "EUR"
          }
        },
        "ultimateCreditor": {
          "name": "myPreferredUltimateMerchant",
          "postalAddress": {
            "country": "FR",
            "addressLine": [
              "18 rue de la DSP2",
              "75008 PARIS"
            ]
          },
          "organisationId": {
            "identification": "85212678900025",
            "schemeName": "SIRET",
            "issuer": "FR"
          }
        },
        "purpose": "CASH",
        "remittanceInformation": {
          "unstructured": [
            "MyRemittanceInformation"
          ]
        },
        "transactionStatus": "PDNG"
      },
      {
        "paymentId": {
          "instructionId": "MyInstrId4",
          "endToEndId": "MyEndToEndId4"
        },
        "requestedExecutionDate": "2020-02-19T13:56:54.759+01:00",
        "instructedAmount": {
          "amount": 124.35,
          "currency": "EUR"
        },
        "beneficiary": {
          "creditor": {
            "name": "John Doe",
            "postalAddress": {
              "country": "FR",
              "addressLine": [
                "18 rue de la DSP2",
                "75008 PARIS"
              ]
            },
            "organisationId": {
              "identification": "12FR5",
              "schemeName": "COID",
              "issuer": "ACPR"
            },
            "privateId": {
              "identification": "852126789",
              "schemeName": "SIREN",
              "issuer": "FR"
            }
          },
          "creditorAccount": {
            "iban": "YY27KYHO61109079868328944728829436",
            "currency": "EUR"
          }
        },
        "ultimateCreditor": {
          "name": "myPreferredUltimateMerchant",
          "postalAddress": {
            "country": "FR",
            "addressLine": [
              "18 rue de la DSP2",
              "75008 PARIS"
            ]
          },
          "organisationId": {
            "identification": "85212678900025",
            "schemeName": "SIRET",
            "issuer": "FR"
          }
        },
        "purpose": "CASH",
        "remittanceInformation": {
          "unstructured": [
            "MyRemittanceInformation"
          ]
        },
        "transactionStatus": "PDNG"
      }
    ],
    "supplementaryData": {
      "acceptedAuthenticationApproach": [
        "REDIRECT",
        "DECOUPLED"
      ],
      "appliedAuthenticationApproach": "REDIRECT",
      "successfulReportUrl": "http://myPisp/PaymentSuccess",
      "unsuccessfulReportUrl": "http://myPisp/PaymentFailure"
    }
  },
  "_links": {
    "request": {
      "href": "/v1/payment-requests/MyPmtInfRscId"
    },
    "confirmation": {
      "href": "/v1/payment-requests/MyPmtInfRscId/confirmation"
    }
  }
}
obOpen Banking Lab
From spec to implementation.

Open banking specifications, glossary and references.

Navigation
  • Glossary
  • STET
  • Blog
  • Contact
Legal
  • Legal notice
  • Privacy policy
  • Cookie policy

© 2026 Open Banking Lab.

Maintained by Tancrède Simonin · Content licensed under CC BY-SA 4.0.