User.newsale

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.

Info

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

Parameters

• 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

Returns

• 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

Example

REQUEST:

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

RESPONSE:

<?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&amp;c=http%3A%2F%2Fexample.com%2Fsale-cancel</paymentlink>
</sale>

REQUEST:

https://api.safecreative.org/v2/
?authkey=6i716m0pecao2morajk4b6xt9
&component=user.newsale
&service=PROFESSIONAL
&promotioncode=SOME_GIFT_CODE
&ztime=1470824468855
&signature=061eae0fb02f2fd29d51d72f784e80667511a847

RESPONSE:

<?xml version="1.0" encoding="UTF-8"?>
<sale>
  <code>PS1608100003281</code>
  <status>PROCESSED</status>
</sale>