offer) is returned in the POST /payments response whenever the checkout page has an upsell configured and the payment succeeds.
POST /upsell
This endpoint is not host-restricted — it can be called from any origin, making it safe to invoke directly from client-side code.
offer SGID returned by POST /payments to charge the customer for the upsell product without requiring them to re-enter payment information.
Base URL: https://pay.nova.money/api/v1
Request Body
The signed GlobalID (SGID) returned in the
offer field of a successful POST /payments response. This token encodes the upsell offer details and authorizes the one-click charge.Optional key/value metadata to attach to the upsell order. Use this for attribution tracking, funnel identifiers, or any custom data your application needs.
Request Example
Response — UpsellResult
Status of the upsell order after processing. Uses the same set of values as the Payments API:
pending, waiting_payment, partially_paid, paid, cancelled, partially_refunded, refunded, billed.Gateway-side payment IDs (e.g., Pagar.me charge IDs or Stripe PaymentIntent IDs) for the upsell charge(s).
URL to a bank slip (boleto) for the upsell order. Present only if the original order used bank slip as the payment method.
Base64-encoded Pix QR code image for the upsell charge. Present only if the original order used Pix.
URL to a hosted Pix QR code page for the upsell charge. Present only if the original order used Pix.
ISO 8601 datetime after which the Pix QR code expires. Present only if the original order used Pix.