Skip to main content
POST
/
links#partners
Create payment link on behalf of a store
curl --request POST \
  --url 'https://api.wava.co/v1/links#partners' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --header 'X-API-Secret: <api-key>' \
  --header 'merchant-key: <api-key>' \
  --data '
{
  "amount": 150000,
  "description": "Monthly subscription - Store ABC",
  "currency": "COP",
  "order_key": "partner-sub-001",
  "redirect_link": "https://partner-platform.com/success"
}
'
{
  "data": {
    "payment_link_id": 5678,
    "payment_url": "https://checkout.wava.co/aBcDeFgH",
    "hash": "aBcDeFgH",
    "expires_at": "2025-03-15T23:59:59.000Z"
  }
}

Authorizations

​
X-API-Key
string
header
required

Partner API key for platform partners. Must be combined with X-API-Secret header for partner operations. Both headers are required for two-factor authentication.

X-API-Key: YOUR_PARTNER_API_KEY
X-API-Secret: YOUR_PARTNER_SECRET_KEY
merchant-key: STORE_MERCHANT_KEY
​
X-API-Secret
string
header
required

Partner API secret for platform partners. Must be combined with X-API-Key header for partner operations. Both headers are required for two-factor authentication.

​
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 on behalf of store

​
data
object