Create payment session

Create a new payment session

Request

Create a new payment session

amountintegerRequired0-1000000000000

Payment amount in minor units (e.g. cents)

currencyenumRequired

Currency code

merchantReferencestringRequired

Unique merchant reference. Recommended to be only alphanumeric characters (for acceptance across providers, otherwise note that they might appear stripped to alphanumerics on customer’s statements, e.g. ref-123 -> ref123)

merchantIdstringRequiredformat: "uuid"

Merchant UUID

payerDetailsobjectRequired

Payer details

integrationTypeenumRequired

Integration type

Allowed values:

redirectUrlstringOptionalformat: "uri"

Redirect URL after payment

paymentAttributesmap from strings to stringsOptional

Payment-specific attributes and metadata that will be stored with the session

Response

Session created successfully

sessionIdstring

Unique identifier for the session

paymentLinkstring or null

URL for the hosted checkout payment

payerIdstring or nullformat: "uuid"

Unique identifier for the payer

signaturestring or null

HMAC signature for session verification

1	import requests
2
3	url = "https://api.payos.money/api/v1/checkout/session"
4
5	headers = {"Content-Type": "application/json"}
6
7	response = requests.post(url, headers=headers)
8
9	print(response.json())

1	{
2	"sessionId": "550e8400-e29b-41d4-a716-446655440003",
3	"paymentLink": "https://payos.com/checkout/550e8400-e29b-41d4-a716-446655440003",
4	"payerId": "550e8400-e29b-41d4-a716-446655440001",
5	"signature": "a8fdc205a9f19cc1c7507a60c4f01b13d11d7fd0"
6	}

Request

Response

Errors