v50

latestOpenAPI 3.0.0raw.githubusercontent.com2026-04-202547455.8 KB
Payment notification

Send payment notification with payment ID

Sends a payment notification for an order based on the payment ID.

ℹ If the payment was made on its creation date and for the full amount, use this endpoint. Otherwise, use the alternative endpoint: POST Send payment notification with payment ID, date, and value paid.

Permissions

Any user or API key must have at least one of the appropriate License Manager resources to be able to successfully run this request. Otherwise, they will receive a status code 403 error. These are the applicable resources for this endpoint:

ProductCategoryResource
PCI GatewayPayment-NotifyPaymentsPayments Notification

You can create a custom role with that resource or use one of the following predefined roles:

RoleResource
Payments NotifierPayments Notification

To learn more about machine authentication at VTEX, see Authentication overview.

get/api/payments/pvt/payments/{paymentId}/payment-notification

Path parameters

paymentIdstring required
Example:B075A551595A43B0AD48DCD8EB481C7F

Payment identification.

Headers

Content-Typestring required
Example:application/json

Type of the content being sent.

Acceptstring required
Example:application/json

HTTP Client Negotiation Accept Header. Indicates the types of responses the client can understand.

Response

OK