User.newsale - Revision history

Adminwiki: 8 revisions imported

2021-05-07T08:07:32Z

8 revisions imported

← Older revision	Revision as of 08:07, 7 May 2021
(No difference)

w>Jguillo: /* Example */

2016-08-10T13:04:48Z

Example

← Older revision		Revision as of 13:04, 10 August 2016
Line 53:		Line 53:

	<pre>		<pre>
	~~<nowiki>~~
	<?xml version="1.0" encoding="UTF-8"?>		<?xml version="1.0" encoding="UTF-8"?>
	<sale>		<sale>
Line 60:		Line 59:
	<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>		<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>		</sale>
	~~</nowiki>~~
	</pre>		</pre>

w>Jguillo: /* Example */

2016-08-10T13:04:29Z

Example

← Older revision		Revision as of 13:04, 10 August 2016
Line 53:		Line 53:

	<pre>		<pre>
	<nowiki>		<nowiki>
	<?xml version="1.0" encoding="UTF-8"?>		<?xml version="1.0" encoding="UTF-8"?>
	<sale>		<sale>
Line 60:		Line 60:
	<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>		<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>		</sale>
	</nowiki>		</nowiki>
	</pre>		</pre>

w>Jguillo: /* Example */

2016-08-10T13:03:49Z

Example

← Older revision		Revision as of 13:03, 10 August 2016
Line 53:		Line 53:

	<pre>		<pre>
			<nowiki>
	<?xml version="1.0" encoding="UTF-8"?>		<?xml version="1.0" encoding="UTF-8"?>
	<sale>		<sale>
Line 59:		Line 60:
	<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>		<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>		</sale>
			</nowiki>
	</pre>		</pre>

w>Jguillo: /* Example */

2016-08-10T12:57:06Z

Example

← Older revision		Revision as of 12:57, 10 August 2016
Line 57:		Line 57:
	<code>PS1608100003311</code>		<code>PS1608100003311</code>
	<status>PAYMENT_PENDING</status>		<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>		<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></pre>		</sale>
			</pre>

	REQUEST:		REQUEST:

w>Jguillo at 12:55, 10 August 2016

2016-08-10T12:55:15Z

← Older revision		Revision as of 12:55, 10 August 2016
Line 3:		Line 3:
	The component returns a URL that the user must visit to complete payment.		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 ~~without any~~ further process.		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.		You must be a Safe Creative partner to use this component.

w>Jguillo at 12:54, 10 August 2016

2016-08-10T12:54:21Z

← Older revision		Revision as of 12:54, 10 August 2016
Line 1:		Line 1:
	Creates a new sale for a professional or corporate account.		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 without any further process.

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

w>Jguillo: /* Returns */

2016-08-10T12:49:51Z

Returns

← Older revision		Revision as of 12:49, 10 August 2016
Line 29:		Line 29:
	** '''code''' Sale code		** '''code''' Sale code
	** '''status''' Sale status		** '''status''' Sale status
	*** ''PAYMENT_PENDING'' Sale is pending payment, a payment link is returned		*** ''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.		*** ''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		** '''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

w>Jguillo: Created page with 'Creates a new sale for a professional or corporate account. You must be a Safe Creative partner to use this component. = Info = * '''Component name''': user.newsale * '''Signa…'

2016-08-10T12:49:33Z

Created page with 'Creates a new sale for a professional or corporate account. You must be a Safe Creative partner to use this component. = Info = * '''Component name''': user.newsale * '''Signa…'

New page

Creates a new sale for a professional or corporate account.

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.

<nowiki>*</nowiki> 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:

<nowiki>https://api.safecreative.org/v2/</nowiki>
?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:

<pre>
<?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></pre>

REQUEST:

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

RESPONSE:

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

[[Category:API component]]