Skip to main content
POST
/
api
/
v1
/
embedded
/
payment-requests
Create a payment request and return a payment_token for iframe flow
curl --request POST \
  --url https://core-dev.quidkey.com/api/v1/embedded/payment-requests \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customer": {
    "name": "Jack Haversham",
    "email": "[email protected]",
    "phone": "+4917646793347",
    "country": "DE"
  },
  "order": {
    "order_id": "ORD-123456",
    "amount": 9300,
    "currency": "EUR",
    "payment_reference": "Barcelona Tryp",
    "locale": "en-GB",
    "test_transaction": true,
    "rewards": {
      "extra_rewards": 150,
      "total_rewards": 300,
      "description": "Loyalty bonus + base rewards"
    }
  },
  "device_type": "ios",
  "redirect_urls": {
    "success_url": "https://tryp.com/checkout/success",
    "failure_url": "https://tryp.com/checkout/error"
  }
}
'
{
  "success": true,
  "data": {
    "payment_token": "ptok_efghijklm...",
    "expires_in": 900
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request body

​
customer
object
required
​
order
object
required
​
redirect_urls
object
required
​
device_type
enum<string>
default:web

Platform/device type for the payment request

Available options:
web,
ios,
android
Example:

"ios"

Response

Created

​
success
boolean
required

Indicates if the request was successful

Example:

true

​
data
object
required