> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rocka.live/llms.txt
> Use this file to discover all available pages before exploring further.

# Callbacks

Rocka will send you payment and payout callbacks to the `webhookUrl` you provided.

## Open banking payments

### Regular webhooks

<Tabs>
  <Tab title="Successful payment (fully settled)">
    ```json expandable lines theme={null}
    {
    "PaymentId":"bc973098-3dfb-4700-af20-28ca4fdb583a",
    "Status":"Done",
    "Signature":"b2e286bfc7b94ab2342342341881c85b50f286b23462436432d7dfc5fcd05ca2r234r231",
    "MerchantPaymentId":"12345678-1234-1234-1234-12345678910",
    "Reference":"M816254739082 IN",
    "Amount":50.0,
    "Currency":"EUR",
    "CardId":null,
    "Remitter":{
        "Name":"Max Mustermann",
        "Iban":"DE17500105179569697752",
        "SortCode":null,
        "AccountNumber":null
    },
    "AdditionalData":null,
    "DetailedInfo":null,
    "Method":"open-banking",
    "BankId":"sparkasse_de",
    "IsSenderBank":false,
    "BankTransactionId":"BANKTRANSACTIONID",
    "Settled":"Yes",
    "SettlementDate":"2024-10-01T07:18:56.316302Z"
    }
    ```
  </Tab>

  <Tab title="Successful payment (awaiting settlement)">
    ```json expandable lines theme={null}
    {
      "PaymentId": "192142e8-e723-47a4-8db1-27690ac37a28",
      "Status": "Done",
      "Signature": "3b0aeedd56acca8fd574d54b89982aac15f033052f4a2f01024a32d47c537d0a",
      "MerchantPaymentId": "order123",
      "Reference": "P264739851096 IN",
      "Amount": 50.0,
      "Currency": "EUR",
      "CardId": null,
      "Remitter": {
        "Name": "Max Mustermann",
        "Iban": "DE17500105179569697752",
        "SortCode": null,
        "AccountNumber": null
      },
      "AdditionalData": null,
      "DetailedInfo": null,
      "Method": "open-banking",
      "BankId": "sparkasse_de",
      "IsSenderBank": false,
      "BankTransactionId": null,
      "Settled": "No",
      "SettlementDate": null,
      "CardNumberLast4": null
    }
    ```
  </Tab>

  <Tab title="Failed payment">
    ```json expandable lines theme={null}

    {
    "PaymentId":"fa315e4d-bc55-4671-88ff-ece52a801690",
    "Status":"Failed",
    "Signature":"b2e286bfc7b94ab2342342341881c85b50f286b23462436432d7dfc5fcd05ca2r234r231",
    "MerchantPaymentId":"12345678-1234-1234-1234-12345678910",
    "Reference":"Q583961274085 IN",
    "Amount":50.0,
    "Currency":"EUR",
    "CardId":null,
    "Remitter":{
        "Name":"Max Mustermann",
        "Iban":"DE17500105179569697752",
        "SortCode":null,
        "AccountNumber":null
    },
    "AdditionalData":null,
    "DetailedInfo":null,
    "Method":"open-banking",
    "BankId":"sparkasse_de",
    "IsSenderBank":false,
    "BankTransactionId":null,
    "Settled":"No",
    "SettlementDate":null
    }
    ```
  </Tab>
</Tabs>

### Extended webhooks

Extended webhooks include additional metadata, such as the decline reason for failed payments. For more information on how to set up extended webhooks, see [Set up extended webhooks](/webhooks/set-up-extended-webhooks). For more information on payment decline reasons, see [Payment decline reasons](/manage-your-account/your-balance-and-transactions/payment-decline-reasons).

<Tabs>
  <Tab title="Awaiting confirmation">
    ```json expandable lines theme={null}
    {
     "PaymentId": "034225e4-faf0-48ca-a9d2-78eb05162cd2",
     "Status": "Awaiting confirmation",
     "Signature": "19841111afb86adadc41c57ef5b54850711814905232e503c4514fee23a35cd7",
     "MerchantPaymentId": "515ede8d-7ebd-4f0b-8608-6f6a0effd88a",
     "Reference": "7U8QO73D PAYMENT",
     "Amount": 123,
     "Currency": "EUR",
     "CardId": null,
     "Remitter": {
        "Name": "Max Mustermann",
        "Iban": "DE17500105179569697752",
        "SortCode": null,
        "AccountNumber": null
     },
     "AdditionalData": null,
     "DetailedInfo": {
        "RejectReason": null,
        "ProcessingStatus": "ApprovedByBank"
     },
     "Method": "open-banking",
     "BankId": "sparkasse_de",
     "IsSenderBank": true,
     "BankTransactionId": null,
     "Settled": "No",
     "SettlementDate": null
    }
    ```
  </Tab>

  <Tab title="Succesful payment">
    ```json expandable lines theme={null}
    {
     "PaymentId":"bc973098-3dfb-4700-af20-28ca4fdb583a",
     "Status":"Done",
     "Signature":"b2e286bfc7b94ab2342342341881c85b50f286b23462436432d7dfc5fcd05ca2r234r231",
     "MerchantPaymentId":"12345678-1234-1234-1234-12345678910",
     "Reference":"12345678 PAYMENT",
     "Amount":50.0,
     "Currency":"EUR",
     "CardId":null,
     "Remitter":{
        "Name":"Max Mustermann",
        "Iban":"DE17500105179569697752",
        "SortCode":null,
        "AccountNumber":null
     },
     "AdditionalData":null,
     "DetailedInfo":{
        "RejectReason":null,
        "ProcessingStatus":"Settled"
     },
     "Method":"open-banking",
     "BankId":"sparkasse_de",
     "IsSenderBank":false,
     "BankTransactionId":"BANKTRANSACTIONID",
     "Settled":"Yes",
     "SettlementDate":"2024-10-01T07:18:56.316302Z"
    }
    ```
  </Tab>

  <Tab title="Failed payment (Blocked by risk)">
    ```json expandable lines theme={null}
    {
     "PaymentId":"4f8b1e6c-9a3d-475e-b2c7-6d9a3f1e8c47",
     "Status":"Failed",
     "Signature":"a2f9c6e3d8b7104ea9f6c3e8d1b704ea7c9f2d5b8e1a4c7f9d2b6e3a8c5f1d9b",
     "MerchantPaymentId":"89012345-8901-8901-8901-89012345678b",
     "Reference":"M816254739082 IN",
     "Amount":50.0,
     "Currency":"EUR",
     "CardId":null,
     "Remitter":{
        "Name":"Max Mustermann",
        "Iban":"DE17500105179569697752",
        "SortCode":null,
        "AccountNumber":null
     },
     "AdditionalData":null,
     "DetailedInfo":{
        "RejectReason":"BLOCKED BY RISK",
        "ProcessingStatus":null
     },
     "Method":"open-banking",
     "BankId":"sparkasse_de",
     "IsSenderBank":false,
     "BankTransactionId":"BANKTRANSACTIONID",
     "Settled":"No",
     "SettlementDate":"2026-08-09T15:07:43.451926Z"
    }   
    ```
  </Tab>

  <Tab title="Failed payment (Blocked validation)">
    ```json expandable lines theme={null}
    {
     "PaymentId": "a749684c-0a26-48bc-a9a3-388bc22f94b7",
     "Status": "Failed",
     "Signature": "4d49b0ce1309d6caf7257b85d5cb71a85c0c11ab646baad49bab41c193a2e67d",
     "MerchantPaymentId": "48295013-7592-3841-9204-58301928475",
     "Reference": "E394856880734 IN",
     "Amount": 20000,
     "Currency": "EUR",
     "CardId": null,
     "Remitter": {
        "Name": "Not Provided",
        "Iban": null,
        "SortCode": null,
        "AccountNumber": null
      },
     "AdditionalData": null,
     "DetailedInfo": {
        "RejectReason": "BLOCKED VALIDATION",
        "ProcessingStatus": null
      },
     "Method": "open-banking",
     "BankId": "erste_bankaustria_at1",
     "IsSenderBank": false,
     "BankTransactionId": null,
     "Settled": "No",
     "SettlementDate": null,
     "CardNumberLast4": null
    }  
    ```
  </Tab>

  <Tab title="Failed payment (Form expired)">
    ```json expandable lines theme={null}
    {
     "PaymentId":"7a3e9c1f-4d8b-462a-9f5c-1e7d4a9c3b68",
     "Status":"Failed",
     "Signature":"d9b4a7c1f5e2036da7c1f4e9b6203da8c4f7e1a9d6b3c8f2a5d9e1c4b7a3f6d0",
     "MerchantPaymentId":"78901234-7890-7890-7890-78901234567a",
     "Reference":"L462987315204 IN",
     "Amount":50.0,
     "Currency":"EUR",
     "CardId":null,
     "Remitter":{
        "Name":"Max Mustermann",
        "Iban":"DE17500105179569697752",
        "SortCode":null,
        "AccountNumber":null
     },
     "AdditionalData":null,
     "DetailedInfo":{
        "RejectReason":"FORM EXPIRED",
        "ProcessingStatus":null
     },
     "Method":"open-banking",
     "BankId":"sparkasse_de",
     "IsSenderBank":false,
     "BankTransactionId":"BANKTRANSACTIONID",
     "Settled":"No",
     "SettlementDate":"2026-07-25T22:16:04.983271Z"
    }   
    ```
  </Tab>

  <Tab title="Failed payment (Initiation failed)">
    ```json expandable lines theme={null}
    {
     "PaymentId":"2d6f9c4a-7e1b-483d-a659-8c3f7e1a9d52",
     "Status":"Failed",
     "Signature":"f1a8c4e7d2b9053fa8c2e6d9b4107fc3a7e9d2c8b5f1a4e8c9d3b6f2a5e8c1d4",
     "MerchantPaymentId":"67890123-6789-6789-6789-67890123456f",
     "Reference":"K857293641075 IN",
     "Amount":50.0,
     "Currency":"EUR",
     "CardId":null,
     "Remitter":{
        "Name":"Max Mustermann",
        "Iban":"DE17500105179569697752",
        "SortCode":null,
        "AccountNumber":null
     },
     "AdditionalData":null,
     "DetailedInfo":{
        "RejectReason":"FINANCIAL INSTITUTION: INITIATION FAILED",
        "ProcessingStatus":null
     },
     "Method":"open-banking",
     "BankId":"sparkasse_de",
     "IsSenderBank":false,
     "BankTransactionId":"BANKTRANSACTIONID",
     "Settled":"No",
     "SettlementDate":"2026-08-12T04:38:51.129467Z"
    }   
    ```
  </Tab>

  <Tab title="Failed payment (Initiation rejected)">
    ```json expandable lines theme={null}
    {
     "PaymentId":"9e4c7a1f-3b6d-489a-8c2e-5f9d3a7b1e64",
     "Status":"Failed",
     "Signature":"c8a3f7e1d4b9026ca7f3e9c2d6b5108ec4a8f1d7b3e6a9c2f5d8b1e4a7c9f3d6",
     "MerchantPaymentId":"56789012-5678-5678-5678-56789012345e",
     "Reference":"J394857261048 IN",
     "Amount":50.0,
     "Currency":"EUR",
     "CardId":null,
     "Remitter":{
        "Name":"Max Mustermann",
        "Iban":"DE17500105179569697752",
        "SortCode":null,
        "AccountNumber":null
     },
     "AdditionalData":null,
     "DetailedInfo":{
        "RejectReason":"FINANCIAL INSTITUTION: INITIATION REJECTED",
        "ProcessingStatus":null
     },
     "Method":"open-banking",
     "BankId":"sparkasse_de",
     "IsSenderBank":false,
     "BankTransactionId":"BANKTRANSACTIONID",
     "Settled":"No",
     "SettlementDate":"2026-08-05T20:41:16.702384Z"
    }   
    ```
  </Tab>

  <Tab title="Failed payment (Initiation abandoned)">
    ```json expandable lines theme={null}
    {
     "PaymentId":"6b9d4f2a-1e8c-47a3-9d5b-3f8a1c6e9d24",
     "Status":"Failed",
     "Signature":"b4e9c2a7f5d81036e4a9c7f2d5b8106e3a9f4c8d1b7e2a5f9c3d6b1e8a4f7c2d",
     "MerchantPaymentId":"45678901-4567-4567-4567-45678901234d",
     "Reference":"H720384951627 IN",
     "Amount":50.0,
     "Currency":"EUR",
     "CardId":null,
     "Remitter":{
        "Name":"Max Mustermann",
        "Iban":"DE17500105179569697752",
        "SortCode":null,
        "AccountNumber":null
     },
     "AdditionalData":null,
     "DetailedInfo":{
        "RejectReason":"FINANCIAL INSTITUTION: INITIATION ABANDONED",
        "ProcessingStatus":null
     },
     "Method":"open-banking",
     "BankId":"sparkasse_de",
     "IsSenderBank":false,
     "BankTransactionId":"BANKTRANSACTIONID",
     "Settled":"No",
     "SettlementDate":"2026-08-10T11:27:38.564923Z"
    }   
    ```
  </Tab>

  <Tab title="Failed payment (Form abandoned)">
    ```json expandable lines theme={null}
    {
     "PaymentId":"a1f7d3e9-6c2b-4890-b5a1-8d3e7f9c2a41",
     "Status":"Failed",
     "Signature":"e7c4a1f8d5b2946ce1a7f4d8b5926c3ea9f1d4b7c2a8e5f9c1d4b7a2e8f5c9d1",
     "MerchantPaymentId":"34567890-3456-3456-3456-34567890123c",
     "Reference":"G581926473058 IN",
     "Amount":50.0,
     "Currency":"EUR",
     "CardId":null,
     "Remitter":{
        "Name":"Max Mustermann",
        "Iban":"DE17500105179569697752",
        "SortCode":null,
        "AccountNumber":null
     },
     "AdditionalData":null,
     "DetailedInfo":{
        "RejectReason":"FORM ABANDONED",
        "ProcessingStatus":null
     },
     "Method":"open-banking",
     "BankId":"sparkasse_de",
     "IsSenderBank":false,
     "BankTransactionId":"BANKTRANSACTIONID",
     "Settled":"No",
     "SettlementDate":"2026-07-28T16:53:07.291645Z"
    }   
    ```
  </Tab>

  <Tab title="Failed payment (Payment rejected)">
    ```json expandable lines theme={null}
    {
     "PaymentId":"3c8e1f4a-9b27-4d6c-a851-2e7f9c4d8b36",
     "Status":"Failed",
     "Signature":"5d2a8f7e1c4b9036a7f2e8c1d5b4a907f3e6c9d2a8f7e1c4b9036a7f2e8c1d5b",
     "MerchantPaymentId":"23456789-2345-2345-2345-23456789012b",
     "Reference":"F193847265091 PAYMENT",
     "Amount":50.0,
     "Currency":"EUR",
     "CardId":null,
     "Remitter":{
        "Name":"Max Mustermann",
        "Iban":"DE17500105179569697752",
        "SortCode":null,
        "AccountNumber":null
     },
     "AdditionalData":null,
     "DetailedInfo":{
        "RejectReason":"FINANCIAL INSTITUTION: PAYMENT REJECTED",
        "ProcessingStatus":null
     },
     "Method":"open-banking",
     "BankId":"sparkasse_de",
     "IsSenderBank":false,
     "BankTransactionId":"BANKTRANSACTIONID",
     "Settled":"No",
     "SettlementDate":"2026-08-03T09:14:22.837451Z"
    }   
    ```
  </Tab>

  <Tab title="Failed payment (Payment expired)">
    ```json expandable lines theme={null}
    {
     "PaymentId":"7f3a92b1-5e6d-4c8a-9f21-8b6d3e4a71c9",
     "Status":"Failed",
     "Signature":"a91f3c8d6e2b47a9f5c1d8e3b6a2f947c1e8d3b6a294f7c1e8d3b6a2f947c1e8",
     "MerchantPaymentId":"87654321-4321-4321-4321-09876543210a",
     "Reference":"E827461950382 IN",
     "Amount":50.0,
     "Currency":"EUR",
     "CardId":null,
     "Remitter":{
        "Name":"Max Mustermann",
        "Iban":"DE17500105179569697752",
        "SortCode":null,
        "AccountNumber":null
     },
     "AdditionalData":null,
     "DetailedInfo":{
        "RejectReason":"FINANCIAL INSTITUTION: PAYMENT EXPIRED",
        "ProcessingStatus":null
     },
     "Method":"open-banking",
     "BankId":"sparkasse_de",
     "IsSenderBank":false,
     "BankTransactionId":"BANKTRANSACTIONID",
     "Settled":"No",
     "SettlementDate":"2026-08-14T13:42:29.104857Z"
    }   
    ```
  </Tab>
</Tabs>

## Payouts

<Tabs>
  <Tab title="Successful payout">
    ```json expandable lines theme={null}
    {  
       "Id":"12345678test123456789",  
       "Status":"Done",  
       "CreatedAt":"2024-10-07T06:13:51.0834821Z",  
       "ExecutedAt":"2024-10-07T06:15:04.4400235Z",  
       "Amount":1000,  
       "Fee":12,  
       "Currency":"EUR",  
       "RequestId":null,  
       "RejectReason":null,  
       "Type":"OpenBanking",  
       "CardNumber":null,  
       "CardHolderReference":null,  
       "Iban":"TT123456789HFE112345",  
       "BeneficiaryName":"John Doe",  
       "BeneficiaryRef":"12345678 PAYOUT",  
       "Signature":"b2e286bfc7b94ab2342342341881c85b50f286b23462436432d7dfc5fcd05ca2r234r231",
      }
    ```
  </Tab>

  <Tab title="Failed payout">
    ```json expandable lines theme={null}
    {  
       "Id":"12345678test123456789",  
       "Status":"Failed",  
       "CreatedAt":"2024-10-07T06:13:51.0834821Z",  
       "ExecutedAt":"2024-10-07T06:15:04.4400235Z",  
       "Amount":1000,  
       "Fee":12,  
       "Currency":"EUR",  
       "RequestId":null,  
       "RejectReason":null,  
       "Type":"OpenBanking",  
       "CardNumber":null,  
       "CardHolderReference":null,  
       "Iban":"TT123456789HFE112345",  
       "BeneficiaryName":"User Testing",  
       "BeneficiaryRef":"12345678 PAYOUT",  
       "Signature":"b2e286bfc7b94ab2342342341881c85b50f286b23462436432d7dfc5fcd05ca2r234r231",
      }
    ```
  </Tab>

  <Tab title="Rejected payout">
    ```json expandable lines theme={null}
    {
        "Id": "e00d0e92bcee43dea15efb65fc597509",
        "Status": "Rejected",
        "CreatedAt": "2026-03-30T11:19:33.0866336Z",
        "ExecutedAt": "2026-03-30T11:19:47.5517654Z",
        "Amount": 11,
        "Fee": 0,
        "Currency": "EUR",
        "RequestId": "392uj9joiq",
        "RejectReason": null,
        "Type": "OpenBanking",
        "CardNumber": null,
        "CardHolderReference": null,
        "Iban": "FI1410093000123458",
        "BeneficiaryName": "John Doe",
        "BeneficiaryRef": "9ZMT1TTK PAYOUT",
        "Signature": "0396e7e4dd5167ece4cd37b2611c5d13102ab75fa7943ac05995d06cd6fe31e8"
    }
    ```
  </Tab>
</Tabs>