Skip to main content
POST
/
api
/
message
/
pix
/
:instance
Send Pix
curl --request POST \
  --url https://api.example.com/api/message/pix/:instance \
  --header 'Content-Type: <content-type>' \
  --header 'token: <token>' \
  --data '
{
  "number": "<string>",
  "merchantName": "<string>",
  "pixKey": "<string>",
  "pixKeyType": "<string>",
  "delay": 123,
  "replyTo": "<string>",
  "replyPrivate": true,
  "source": "<string>"
}
'
Auth: TokenAccount or TokenInstance • Rate-limit: Global (100/min) • Idempotent: no

​
Description

Sends a message with a visual PIX card in the WhatsApp chat, displaying the beneficiary name, the key type and the key itself. The button works as a “copy key” with PIX styling, when tapped, the recipient copies the key to the clipboard and pastes it into their banking app to pay. It does not open a payment screen, does not create a charge, and there is no confirmation callback, it is just the visual presentation of the key in a friendly, clickable format.

​
Examples

​
PIX with CPF Key

Sends the PIX button using a CPF key. Send digits only (no dots or dashes). 
curl -X POST "https://ryzeapi.cloud/api/message/pix/$Instance_Name" \
  -H "token: $Token_Instance" \
  -H "Content-Type: application/json" \
  -d '{
    "number":       "5511999999999",
    "merchantName": "RyzeAPI Tecnologia",
    "pixKey":       "12345678901",
    "pixKeyType":   "CPF"
  }'

​
PIX with CNPJ Key

Sends the PIX button using a CNPJ key. Send digits only (no dots, dashes or slashes). 
curl -X POST "https://ryzeapi.cloud/api/message/pix/$Instance_Name" \
  -H "token: $Token_Instance" \
  -H "Content-Type: application/json" \
  -d '{
    "number":       "5511999999999",
    "merchantName": "RyzeAPI Tecnologia",
    "pixKey":       "12345678000199",
    "pixKeyType":   "CNPJ"
  }'

​
PIX with Email Key

Sends the PIX button using an EMAIL key. 
curl -X POST "https://ryzeapi.cloud/api/message/pix/$Instance_Name" \
  -H "token: $Token_Instance" \
  -H "Content-Type: application/json" \
  -d '{
    "number":       "5511999999999",
    "merchantName": "RyzeAPI Tecnologia",
    "pixKey":       "contato@ryzeapi.cloud",
    "pixKeyType":   "EMAIL"
  }'

​
Success response

200 OK
{
  "success": true,
  "message": "Message sent successfully",
  "status":  "sent",
  "data": {
    "messageId":   "3EB08FCF27E532F1B0F5",
    "direction":   "outgoing",
    "messageType": "pix",
    "content":     "",
    "source":      "api",
    "timestamp":   "2026-04-30T14:30:00Z",
    "chat": {
      "jid":     "5511999999999@s.whatsapp.net",
      "isGroup": false
    },
    "sender": {
      "jid":      "5511777777777@s.whatsapp.net",
      "instance": "minha-instancia"
    }
  }
}
The button only copies the PIX key to the recipient’s clipboard, it does not open the bank’s payment screen or initiate a charge. Payment is done manually by the recipient in their own banking app, and there is no “paid” callback via WhatsApp.

​
Path parameters

​
instance
string
required
Instance name (e.g., $Instance_Name).

​
Headers

​
token
string
required
TokenAccount or TokenInstance.
​
Content-Type
string
required
application/json

​
Request body

​
number
string
required
Destination: phone (5511999999999) or JID (@s.whatsapp.net, @lid, @g.us).
​
merchantName
string
required
Beneficiary name displayed on the visual PIX card (above the key).
​
pixKey
string
required
PIX key (CPF, CNPJ, email, phone or random key).
​
pixKeyType
string
required
Key type. Accepted values: CPF, CNPJ, EMAIL, PHONE, RANDOM.
​
delay
int
default:"0"
Time in seconds to wait before sending. During the interval, the server sends the “typing…” indicator to the recipient.
​
replyTo
string
ID of the message to be quoted (reply). The original message must belong to the same instance and have been saved in the database.
​
replyPrivate
boolean
default:"false"
When true and replyTo points to a message originating from a group, the reply is redirected to the original author’s private chat.
​
source
string
default:"api"
Origin identifier for traceability (e.g., crm, checkout, n8n).

​
Notes

  • The pixKeyType is validated by oneof, if you send a value outside CPF | CNPJ | EMAIL | PHONE | RANDOM, the request is rejected with 400.
  • For CPF/CNPJ keys, send digits only (no dots, dashes or slashes): 12345678901 or 12345678000199.
  • For PHONE, use the international format without + (e.g., 5511999999999).
  • For RANDOM, use the UUID generated by the bank (e.g., aabbccdd-1234-5678-90ab-cdef01234567).
  • This endpoint does not create a Brcode QR Code or register a charge, it is only the visual representation of the order with a clickable PIX key.

​
Errors

HTTPInternal statusMessage
400,Instance name is required
400,Invalid request: <detail>
400,Number is required
400,MerchantName is required
400,PixKey is required
400,PixKeyType is required
400invalid_numberInvalid phone number format: <detail>
400invalid_request(oneof validation or other reason)
404,Instance not found
500send_failedFailed to send message: <reason>
503disconnectedInstance is not connected to WhatsApp
Error envelope: 
{
  "success": false,
  "error": { "message": "PixKeyType is required" }
}