Skip to main content
POST
/
links
curl --request POST \
  --url https://api.wava.co/v1/links \
  --header 'Content-Type: application/json' \
  --header 'merchant-key: <api-key>' \
  --data '
{
  "amount": 50000,
  "description": "Invoice #1234 - Web design services",
  "currency": "COP",
  "order_key": "inv-1234",
  "redirect_link": "https://mystore.com/thanks",
  "redirect_link_cancel": "https://mystore.com/cancelled",
  "redirect_link_failure": "https://mystore.com/error"
}
'
{
  "data": {
    "payment_link_id": 5678,
    "payment_url": "https://checkout.wava.co/aBcDeFgH",
    "hash": "aBcDeFgH",
    "expires_at": "2025-03-15T23:59:59.000Z"
  }
}

Authorizations

​
merchant-key
string
header
required

Merchant key for store identification. Required for all API requests.

merchant-key: YOUR_MERCHANT_KEY

Body

application/json
​
description
string
required

Payment description displayed to the buyer.

Required string length: 1 - 255
Example:

"Invoice #1234 - Web design services"

​
amount
number

Payment amount. Omit this field to create a dynamic link where the buyer enters the amount.

Required range: x >= 0.01
Example:

50000

​
currency
string

ISO 4217 currency code. Defaults to store currency.

Pattern: ^[A-Z]{3}$
Example:

"COP"

​
order_key
string

Your external reference for this payment link.

Maximum string length: 100
Example:

"inv-1234"

​
redirect_link
string<uri>

URL to redirect buyer after successful payment.

Example:

"https://mystore.com/thanks"

​
redirect_link_cancel
string<uri>

URL to redirect buyer if payment is cancelled.

Example:

"https://mystore.com/cancelled"

​
redirect_link_failure
string<uri>

URL to redirect buyer if payment fails.

Example:

"https://mystore.com/error"

Response

Payment link created successfully

​
data
object