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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.wava.co/llms.txt

Use this file to discover all available pages before exploring further.

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"

​
collect_shopper_data
boolean
default:false

When true, the checkout page prompts the buyer for contact information (first name, last name, email, phone number) before proceeding to payment method selection. The submitted data is stored with the order.

Only valid on dynamic links (requests without an amount). Setting this to true on a fixed-amount link returns a 400 error.

Example:

true

Response

Payment link created on behalf of store

​
data
object