Get Registration

/api/payhub/v1/registration/{registrationId}

Retrieves the provider and webhook configuration for the registration owned by the authenticated merchant. Only safe, non-credential fields are returned (no passwords, secrets, application keys, or FTP credentials). Only the merchant who owns the registration can retrieve it.

Request parameters

Responses

{
  "registrationId": 192,
  "provider": "klarna",
  "active": true,
  "createdDate": "2026-08-10T12:30:00Z",
  "updatedDate": "2026-08-10T12:35:00+00:00",
  "accountName": "Acme Retail SA",
  "mid": "MID-998877",
  "organisationCode": "12345",
  "iban": "GR1601101250000000012300695",
  "returnUrlOk": "https://merchant.example.com/checkout/success",
  "returnUrlNok": "https://merchant.example.com/checkout/failure",
  "webhook": {
    "url": "https://merchant.example.com/webhooks/payhub",
    "createdDate": "2026-08-10T12:30:00Z",
    "updatedDate": "2026-08-10T12:35:00Z",
    "headers": [
      {
        "headerName": "X-Merchant-Signature",
        "headerValue": "s3cr3t-signing-value"
      }
    ]
  }
}

{
  "type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1",
  "title": "Bad Request",
  "status": 400,
  "instance": "/api/payhub/v1/registration/0",
  "traceId": null,
  "detail": "Invalid registration ID",
  "errors": [
    {
      "name": "RegistrationId",
      "reason": "Registration ID must be a positive integer",
      "code": null,
      "severity": null
    }
  ]
}

{
  "type": "https://www.rfc-editor.org/rfc/rfc7235#section-3.1",
  "title": "Unauthorized",
  "status": 401,
  "instance": "/api/payhub/v1/registration/192",
  "traceId": null,
  "detail": "API key is missing or invalid",
  "errors": [
    {
      "name": "Authorization",
      "reason": "x-api-key header is required",
      "code": null,
      "severity": null
    }
  ]
}

{
  "type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.3",
  "title": "Forbidden",
  "status": 403,
  "instance": "/api/payhub/v1/registration/192",
  "traceId": null,
  "detail": "You are not authorized to access this registration",
  "errors": [
    {
      "name": "Authorization",
      "reason": "Registration belongs to a different merchant",
      "code": null,
      "severity": null
    }
  ]
}

{
  "type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.4",
  "title": "Not Found",
  "status": 404,
  "instance": "/api/payhub/v1/registration/192",
  "traceId": null,
  "detail": "Registration not found",
  "errors": [
    {
      "name": "Registration",
      "reason": "No registration found with the given ID",
      "code": null,
      "severity": null
    }
  ]
}

{
  "type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1",
  "title": "One or more errors occurred.",
  "status": 500,
  "instance": "/api/payhub/v1/registration/192",
  "traceId": null,
  "detail": "Failed to retrieve registration",
  "errors": [
    {
      "name": "Server",
      "reason": "Internal server error",
      "code": null,
      "severity": null
    }
  ]
}

Last modified: 04 September 2026