Skip to main content
POST
/
initiate-payment
Initiate Payment
curl --request POST \
  --url https://staging.tilipayments.com/api/initiate-payment \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 10,
  "currency_code": "EUR",
  "customer": {
    "name": "John Doe",
    "email": "[email protected]",
    "address": "123 Main Street",
    "city": "Metropolis",
    "country_code": "USA",
    "zip_code": "10001"
  },
  "language": "en",
  "line_items": [
    {
      "price": 10,
      "product_name": "Wireless Bluetooth Headphones",
      "quantity": 1
    }
  ],
  "order_reference": "ORDER-1",
  "settings": {
    "cancel_url_override": "https://yourpage.com/cancel_url",
    "language": "en",
    "success_url_override": "https://yourpage.com/success_url"
  }
}
'
{
  "reference": "pmt-48f2ab76ee3db579",
  "redirect_url": "https://staging.tilipayments.com/payment/pmt-48f2ab76ee3db579"
}

Authorizations

Authorization
string
header
required

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

Body

application/json
amount
number
required
Example:

10

currency_code
string
required
Example:

"EUR"

customer
object
required
line_items
object[]
required
order_reference
string
required
Example:

"ORDER-1"

language
string
Example:

"en"

settings
object

Response

Payment link generated successfully.

reference
string
Example:

"pmt-48f2ab76ee3db579"

redirect_url
string
Example:

"https://staging.tilipayments.com/payment/pmt-48f2ab76ee3db579"