Payment Request

/api/payhub/v1/payment/request

Creates a new payment request with the provided details

Request parameters

{
	"Debtor": {
		"CompanyName": "Softone S.A.",
		"Name": "John Doe",
		"VRN": "094123456",
		"Email": "john.doe@example.com",
		"Phone": "+302101234567"
	},
	"Currency": "EUR",
	"Country": "GR",
	"Locale": "el-GR",
	"Provider": "dias",
	"PaymentType": "Fixed",
	"Amount": 125.50,
	"Description": "Invoice INV-2026-0042",
	"Store": {
		"Code": "ATH001",
		"TerminalCode": "TERM1234",
		"Address": {
			"City": "Athens",
			"Country": "GR",
			"Postal_code": "10434",
			"Street_address": "Ermou 12"
		}
	}
}

{
	"Provider": "dias",
	"PaymentType": "Fixed",
	"Amount": 100.00
}

{
	"Provider": "onepay",
	"PaymentType": "Fixed",
	"Amount": 100.00
}

{
	"Provider": "paygate",
	"PaymentType": "Fixed",
	"Amount": 100.00
}

{
	"Provider": "klarna",
	"PaymentType": "DynamicQR",
	"Amount": 100.00,
	"TaxAmount": 0.00,
	"Store": {
		"Code": "ATH001",
		"TerminalCode": "TERM1234",
		"Address": {
			"City": "Athens",
			"Country": "GR",
			"Postal_code": "10434",
			"Street_address": "Ermou 12"
		}
	},
	"OrderLines": [
		{
			"Name": "Item 1",
			"Quantity": 1,
			"UnitPrice": 100.00,
			"TotalAmount": 100.00,
			"Type": "physical"
		}
	]
}

{
	"Provider": "klarna",
	"PaymentType": "StaticQR",
	"ShortCode": "STORE-ATHENS-01",
	"Amount": 100.00,
	"TaxAmount": 0.00,
	"Store": {
		"Code": "ATH001",
		"TerminalCode": "TERM1234",
		"Address": {
			"City": "Athens",
			"Country": "GR",
			"Postal_code": "10434",
			"Street_address": "Ermou 12"
		}
	},
	"Description": "Static QR checkout",
	"OrderLines": [
		{
			"Name": "Item 1",
			"Quantity": 1,
			"UnitPrice": 100.00,
			"TotalAmount": 100.00,
			"Type": "physical"
		}
	]
}

{
	"Provider": "worldline",
	"PaymentType": "Fixed",
	"Amount": 100.00,
	"Debtor": {
		"Email": "john.doe@example.com"
	}
}

{
	"Provider": "viva",
	"PaymentType": "Fixed",
	"Amount": 100.00
}

{
	"Provider": "nexi",
	"PaymentType": "Fixed",
	"Amount": 100.00
}

Responses

{
  "paymentRequestId": 27,
  "paycode": "RF49923973001012300035905",
  "paylink": "https://uat-paygate.be24.gr/?RequestGuid=8246a88d-c06a-436f-87f0-8dd2795b6b56&ProcessGuid=402b5dda-9cb7-4572-9dc8-d21b61c75040&LanID=2",
  "qr": null,
  "createdDate": "2026-08-10T14:23:34.6117681+03:00"
}

{
  "type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1",
  "title": "Bad Request",
  "status": 400,
  "instance": "/api/payhub/v1/payment/request",
  "traceId": "0HNEBBR7M8HMA:00000004",
  "detail": null,
  "errors": [
    {
      "name": "paymentType",
      "reason": "Payment type must be one of the following: Fixed, Open, FixedOpen, SplitPay",
      "code": null,
      "severity": null
    }
  ]
}

{
  "type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.3",
  "title": "Forbidden",
  "status": 403,
  "instance": "/api/payhub/v1/payment/request",
  "traceId": null,
  "detail": "No registration found",
  "errors": [
    {
      "name": "Authorization",
      "reason": "No registration found with apikey or invalid registration ID format.",
      "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/payment/request",
  "traceId": null,
  "detail": "No registration found for Provider 'dias'",
  "errors": [
    {
      "name": "Registration",
      "reason": "No registration found",
      "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/payment/request",
  "traceId": null,
  "detail": "Exception",
  "errors": [
    {
      "name": "Server",
      "reason": "Internal server error",
      "code": null,
      "severity": null
    }
  ]
}

Last modified: 17 June 2026