From SafeCreativeWiki

Jump to: navigation, search

Creates a new sale for a professional or corporate account.

The component returns a URL that the user must visit to complete payment.

A discount or gift code can be provided to apply to the sale. If this results in a zero-priced sale, the professional or corporate account will be automatically assigned to the user and no further process is needed.

You must be a Safe Creative partner to use this component.



  • Component name: user.newsale
  • Signature: Requires signature using the authorization key's private key
  • Timestamp: Requires ztime parameter
  • API trust level: Partner


  • authkey*: The user's authorization key
  • ztime*: Z-Timestamp
  • service*: Service to buy
    • PROFESSIONAL: Professional account
    • CORPORATE: Corporate account
  • promotioncode: Discount or gift code to apply to the sale
  • returnUrl: Return URL for payment page if payment is successful
  • cancelUrl: Return URL for payment page if payment is not completed
    • If return URLs are provided, both URLs must be included.

* Required parameter


  • sale
    • code Sale code
    • status Sale status
      • PAYMENT_PENDING: Sale is pending payment, a payment link is returned
      • PROCESSED: Sale is complete. This may happen if a gift code has been applied to the sale.
    • paymentlink If the sale is pending payment, this is the URL to redirect the user for payment. The link is customized with the provided return URLs




<?xml version="1.0" encoding="UTF-8"?>



<?xml version="1.0" encoding="UTF-8"?>
Personal tools
Safe Stamper API