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
- 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
https://api.safecreative.org/v2/ ?authkey=6i716m0pecao2morajk4b6xt9 &component=user.newsale &service=PROFESSIONAL &returnurl=http%3A%2F%2Fexample.com%2Fsale-return &cancelurl=http%3A%2F%2Fexample.com%2Fsale-cancel &ztime=1470825332701 &signature=81dac42a47e5987595cd4f57843bbe54986152e4
<?xml version="1.0" encoding="UTF-8"?> <sale> <code>PS1608100003311</code> <status>PAYMENT_PENDING</status> <paymentlink>https://account.safecreative.org/sale/PS1608100003311?r=http%3A%2F%2Fexample.com%2Fsale-return&c=http%3A%2F%2Fexample.com%2Fsale-cancel</paymentlink> </sale>
https://api.safecreative.org/v2/ ?authkey=6i716m0pecao2morajk4b6xt9 &component=user.newsale &service=PROFESSIONAL &promotioncode=SOME_GIFT_CODE &ztime=1470824468855 &signature=061eae0fb02f2fd29d51d72f784e80667511a847
<?xml version="1.0" encoding="UTF-8"?> <sale> <code>PS1608100003281</code> <status>PROCESSED</status> </sale>