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-06-12T12:32:30.4719983+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/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