lmplementa<:ión y Operación

The response to the Refund operation includes a response element called the RefundStatus which will be always be set to Pending. You will later receive the final status of the refund request (for example, Completed or Declined) from Amazon Payments through the Instant Payment Notification service. For more information about the Instant Payment Notification service, see Synchronizing your systems with Amazon Payments.

Buyer-facing e-mail content that you can

provide

Amazon sends an e-mail to buyers in the following situations: • When a Billing Agreement object is confirmed

• Any time when an Order Reference object is confirmed. This email is suppressed when the Order Reference is created using a Billing Agreement.

• Any time funds are captured • Any time a refund is issued

• Any time a payment method is changed • Any time the address is changed

• Any time you or the buyer close the billing agreement

Amazon supplies most of the content for the e-mails, but there are several elements within the body of the message that you can provide. The following table lists the buyer-facing e-mail content that you can define based on account settings and API operation parameters:

E-mail Field Source

Seller customer service e-mail address Specified when you set up your Amazon seller account or from the Seller Central Settings tab under Account Info.

Seller customer service phone number Specified when you set up your Amazon seller account or from the Seller Central Settings tab under Account Info.

Seller store name Specified when you set up your Amazon seller account or from the

Seller Central Settings tab under Account Info. Can be overridden in the SetBillingAgreementDetails operation with the StoreName parameter.

Seller identifier for the billing agreement Specified in the SetBillingAgreementDetails operation with the SellerBillingAgreementId parameter.

Seller note Specified in the SetBillingAgreementDetails operation with the

SellerNote parameter for the Payment Method Setup Notification. Specified in the AuthorizeOnBillingAgreement operation or

Capture operation with the SellerCaptureNote parameter for the Charge Notification.

Specified in the Refund operation with the SellerRefundNote

Declined status for the Authorization object in the response.

Selecting the mode of operation for the AuthorizeOnBillingAgreement operation depends on your business processes and technical systems.

Asynchronous mode

You can select the asynchronous mode of operation by not specifying a value or by specifying a non-zero value to the TransactionTimeout request parameter of the AuthorizeOnBillingAgreement operation. For more information about the valid values for the TransactionTimeout request parameter, see the Off-Amazon Payments API section reference.

The following code example shows how to enable the asynchronous mode on the AuthorizeOnBillingAgreement

operation: https://mws.amazonservices.com/OffAmazonPayments_Sandbox/2013-01-01 ?AWSAccessKeyId=AKIAJKYFSJU7PEXAMPLE &Action=AuthorizeOnBillingAgreement &AmazonBillingAgreementId=C01-1234567-1234567 &AuthorizationAmount.Amount=10 &AuthorizationAmount.CurrencyCode=USD &AuthorizationReferenceId=test_authorize_1 &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &SellerId=YOUR_SELLER_ID_HERE &SellerAuthorizationNote=ForNovemberOrder &SellerOrderAttributes.SellerOrderId=testSellerOrderId &SellerOrderAttributes.StoreName=testStore &SellerOrderAttributes.CustomInformation=ExampleInformation &InheritShippingAddress=true &SignatureMethod=HmacSHA256 &SignatureVersion=2 &Timestamp=2012-10-03T19%3A01%3A11Z &TransactionTimeout=60 &Version=2013-01-01 &Signature=WlQ708aqyHXMkoUBk69Hjxj8qdh3aDcqpY71hVgEXAMPLE

In the asynchronous mode of operation, you will receive an initial Pending status of the Authorization object in the response to your AuthorizeOnBillingAgreement request, typically within 2-3 seconds. You will receive the final processing status (Open or Declined) via Instant Payment Notification, typically within 60 seconds. In rare cases, when Amazon Payments is manually investigating a transaction, you may not receive the final processing status notification for up to the TransactionTimeout value specified by you or for 24 hours if no TransactionTimeout value is specified.

Amazon recommends using the asynchronous mode if your business processes and technical systems can hold a transaction for up to 24 hours. If you receive a Declined status of the Authorization, you will need to notify the buyer of the failed transaction and request them to update the payment method from the Amazon Payments website, collect an alternative form of payment, or cancel the transaction based on the declined reason code. For more information, see

By selecting this mode, you will provide Amazon more time to investigate transactions, usually resulting in a lower Authorization decline rate.

Synchronous mode

You can select the synchronous mode of operation by setting the TransactionTimeout request parameter to 0. The following code example shows how to enable the synchronous mode on the AuthorizeOnBillingAgreement

operation: https://mws.amazonservices.com/OffAmazonPayments_Sandbox/2013-01-01 ?AWSAccessKeyId=AKIAJKYFSJU7PEXAMPLE &Action=AuthorizeOnBillingAgreement &AmazonBillingAgreementId=C01-1234567-1234567 &AuthorizationAmount.Amount=10 &AuthorizationAmount.CurrencyCode=USD &AuthorizationReferenceId=test_authorize_1 &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &SellerId=YOUR_SELLER_ID_HERE &SellerAuthorizationNote=ForNovemberOrder &SellerOrderAttributes.SellerOrderId=testSellerOrderId &SellerOrderAttributes.StoreName=testStore &SellerOrderAttributes.CustomInformation=ExampleInformation &InheritShippingAddress=true &SignatureMethod=HmacSHA256 &SignatureVersion=2 &Timestamp=2012-10-03T19%3A01%3A11Z &TransactionTimeout=0 &Version=2013-01-01 &Signature=WlQ708aqyHXMkoUBk69Hjxj8qdh3aDcqpY71hVgEXAMPLE

In the synchronous mode of operation, you will receive an Open or Declined status of the Authorization object in the response to your AuthorizeOnBillingAgreement request, typically within 6-8 seconds. If Amazon is unable to process the Authorization synchronously, the operation will return a Declined status with a reason code of TransactionTimedOut.

Amazon Payments recommends using the synchronous mode if you have scenarios where you want to authorize and/or capture payments while the buyer is still on your site. For example, you want to offer a digital download or confirm an expedited delivery. In these cases, you may not be able to handle declines in an offline process.

By selecting this mode, you may observe a higher Authorization decline rate as Amazon will convert some Pending Authorizations to Declined. You can determine these Authorization declines by checking for the TransactionTimedOut reason code.

Unlike in asynchronous mode, where you handle Authorization declines through an offline process, in synchronous mode you will be able to handle declines while the buyer is on your site. For more information, see Handling payment declines.

Payments Payment Protection Policy, please review the Amazon Payments User Agreement - Seller Accounts on the Amazon Payments website.

The Amazon Payments Protection policy applies to the sale of physical goods only.

In this case, you must create a Billing Agreement object. To do this, you will have to specify the onReady

callback function as one of the parameters in the widget call. The onReady function will get called with a

billingAgreement object when the widget renders. You can get the billingAgreementId by calling the

getAmazonBillingAgreementId() function on the billingAgreement object.

You must store the amazonBillingAgreementId as you will need it throughout your Login and Pay with Amazon integration.

The following example shows how to render the Wallet widget to support scenarios where you do not want to use the AddressBook widget:

<!—- put the style below inside your CSS file --> <style type="text/css">

#walletWidgetDiv {width: 400px; height: 228px;} </style> <div id="walletWidgetDiv"> </div> <script> new OffAmazonPayments.Widgets.Wallet({ sellerId: 'YOUR_SELLER_ID_HERE', onReady: function(billingAgreement) {

var billingAgreementId = billingAgreement.getAmazonBillingAgreementId(); }, agreementType: 'BillingAgreement', design: { designMode: 'responsive' }, onPaymentSelect: function(billingAgreement) {

// Replace this code with the action that you want to perform // after the payment method is selected.

},

onError: function(error) { // your error handling code }

}).bind("walletWidgetDiv"); </script>

Just like in Step 3 - Add the AddressBook and Wallet widgets of the Getting Started section, you set the size of the widget via the CSS. The Wallet Widget will resize to fit the provided space. You can use media query if you want to build a responsive site where you want the widgets to resize based on the size of the browser window.

Using the collapsible widgets for

smartphones

All Login and Pay with Amazon widgets are optimized for touchscreen, which improves usability on tablets and smartphones. However, if you have a separate website that is optimized for smartphones, then Amazon recommends that you use the collapsible widgets on that website.

The collapsible AddressBook and Wallet widgets are designed to fit in a one-column user interface, and they can be expanded and collapsed to minimize the need for scrolling. They are best for websites where you want to keep the space allocated to the widgets to a minimum and where you want to use the full screen area of the buyer's device. This differs from the standard widgets, which are of fixed height and width and cannot be expanded or collapsed by the buyer. The standard widgets are described in Getting started.

The collapsible AddressBook and Wallet widgets scale to fit the width of the smartphone screen. The collapsible widgets have a fixed height of 135 pixels when collapsed. The buyer can expand the widgets to change the pre-selected shipping address or payment method. In this case the widgets expand to the full height and width of the device. When the buyer makes a selection, the widgets collapse automatically and the buyer can continue checking out.

To integrate the collapsible widgets, follow these steps:

1. Add a meta tag to the head section of each of your smartphone-optimized pages. This meta tag will cause the widgets to scale to be readable on a smartphone without requiring the user to zoom the page:

<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0"/>

2. Modify your code that creates the AddressBook or Wallet widget to set the designMode parameter to

smartphoneCollapsible, as in the following example:

new OffAmazonPayments.Widgets.AddressBook({ sellerId : 'YOUR_SELLER_ID_HERE',

onReady: function(billingAgreement) {

var billingAgreementId = billingAgreement.getAmazonBillingAgreementId(); }, design : { designMode: 'smartphoneCollapsible' }, agreementType: ‘BillingAgreement’, onAddressSelect : function(billingAgreement) { }, onError : function(error) { } }).bind("addressBookWidgetDiv");

The above example shows how to modify the AddressBook widget. You will need to make the same change for the Wallet widget and for the read-only AddressBook and Wallet widgets. You cannot specify the width and height of the collapsible widgets.

The following illustration shows how a buyer interacts with the collapsible widgets:

• Initially, the widgets are collapsed. The widgets show the Amazon default Shipping Address and Payment Method. • If the buyer wants to modify the Shipping Address or Payment Method, the buyer clicks the appropriate Change

button. The widget then expands to fill the entire screen.

• After the buyer selects a different Shipping Address or Payment Method, or hits the Cancel button, the widget collapses again.

Enabling advanced payments scenarios

With the Billing Agreement, you can easily handle a variety of post-purchase and other advanced payments scenarios. The following scenarios are covered:

• Upgrade or downgrade service

• Cancel or suspend service

• Change the payment method

• Change the shipping address

• Simultaneous one time and automatic purchases

Upgrade or downgrade service

If a buyer requests to upgrade or downgrade their subscription or service plan, you may want to charge the buyer a different amount going forward corresponding to the upgrade or downgrade. Also, if the buyer contacts you midway during their billing cycle, you may want to prorate the charges at the end of your billing period.

The Billing Agreement offers you the flexibility to handle this scenario. After you have updated your billing system with the necessary information, you can simply initiate a request to charge the buyer by calling the Capture operation for the appropriate amount.

Note: Amazon imposes a $500 per calendar month limit on the amount of funds you can charge a buyer. If you expect to exceed this limit due to an upgrade or the buyer's usage, please contact Amazon Payments.

Cancel or suspend service

If a buyer contacts you to suspend their service, you can simply stop submitting the payment request to Amazon until the service is resumed. If a buyer contacts you to cancel their service, Amazon recommends that you close the Billing Agreement by calling the CloseBillingAgreement operation. The Billing Agreement status will then be updated in the Your Account section of Amazon Payments website.

The following code example shows how to request the CloseBillingAgreement operation:

https://mws.amazonservices.com/OffAmazonPayments_Sandbox/2013-01-01? AWSAccessKeyId=AKIAJKYFSJU7PEXAMPLE &AmazonBillingAgreementId=C01-8824045-7416542 &ClosureReason=Closing%20OR%20for%20Test &Action=CloseBillingAgreement &SellerId=YOUR_SELLER_ID_HERE &SignatureMethod=HmacSHA256 &SignatureVersion=2 &Timestamp=2013-12-11T12%3A32%3A42.000Z &Version=2013-01-01 &Signature=yrpMpoDfGLu567t611z27v4yJ8SURIVMKcy26sJrwYc%3D

Buyer can also terminate their Billing Agreement from the Amazon Payments website or by contacting Amazon Payments customer service. In that case, Amazon will mark the Billing Agreement as closed on behalf of the buyer. When the Billing Agreement is closed, the buyer will receive a Merchant Authorization Canceled e-mail.

Note: Amazon Payments allows you to specify various pieces of information in the emails sent by Amazon Payments, for example, your customer service email, phone number, or the note from the seller. For more information about these details, please refer to the Buyer Facing Email Content You can Provide section of this guide.

Buyers can update their payment method when the Billing Agreement is in the Open or Suspended state from the Your Account section of the Amazon Payments web site. When the buyer updates the payment method, you will receive an Instant Payment Notification (IPN). For more information on IPNs, see Synchronizing your systems with Amazon Payments. Any subsequent authorizations will be processed using the updated payment method. The payment method associated with any previous authorizations will not be updated.

Updating the payment method from your web site

If you prefer that the buyer update the payment method from your web site, you can use the Wallet widget. To do so: • Request the buyer to log in by placing the Login with Amazon button on your site. If the user is signing-in using

their credentials on your site, you will need to have them authenticate with Amazon. To do so, you may use the Amazon Edit/Update button described in the Step 1 - Add a Button Widget for Buyer Authentication section of this guide.

• Display the Amazon Wallet widget where you want the buyer to update the payment method. For an example, see Step 3 - Add the AddressBook and Wallet widgets. Make sure that you are passing the

amazonBillingAgreementId as an input to the widget to identify the Billing Agreement the buyer wishes to edit. • Each time buyer selects a payment method from the Wallet widget, Amazon will trigger the onPaymentSelect

callback.

• The buyer may click on several payment methods in the widget before making the final selection. After the buyer has made the final selection by clicking the Place Order, Update, or similar button, call the

ConfirmBillingAgreement operation.

After successfully calling the ConfirmBillingAgreement operation, the Billing Agreement object moves from

the Draft state to the Open state. Do NOT call the SetBillingAgreementDetails operation as the Billing

Agreement object is not in a Draft state and you can no longer set additional attributes. You will receive an Instant Payment Notification indicating the updated payment method. • The buyer will receive a Merchant Settings Updated e-mail.

Change the shipping address

If a buyer wants to update the shipping address associated with their Billing Agreement, they can use the Amazon AddressBook widget from your web site. Currently, buyers cannot update the shipping address from the Amazon Payments web site.

To update the shipping address:

• Request the buyer to log in by placing the Login with Amazon button on your site.

• Display the Amazon AddressBook widget where you want the buyer to update the address. For an example, see

Step 3 - Add the AddressBook and Wallet widgets.

• Each time buyer selects an address from the Address widget, Amazon will trigger the onAddressSelect callback. • Amazon requires that each time a buyer selects an address, you render the Amazon Wallet widget and let the

buyer select the allowed payment method for that address. Each time the buyer selects a payment method, Amazon will trigger the onPaymentSelect callback from the Wallet widget. Please make sure you always wait for

confirm the Billing Agreement before the buyer has selected the Payment Method, the ConfirmBillingAgreement

operation will return a PaymentMethodNotUpdated error. If the buyer has updated the payment method, you will

also receive an IPN for payment method update.

• The buyer may click on several addresses in the widget before making the final selection. After the buyer has made the final selection by clicking the Update or similar button, call the ConfirmBillingAgreement operation. After successfully calling the ConfirmBillingAgreement operation, the Billing Agreement object moves from the Draft state to the Open state. Do NOT call the SetBillingAgreementDetails operation as the Billing Agreement object is not in a Draft state and you can no longer set additional attributes.

You will receive an Instant Payment Notification indicating the updated address. If the buyer has updated the payment method, you will also receive another Instant Payment Notification for payment method update. • Please note that the BillingAgreement will be updated with the new address and payment method only

after you call the ConfirmBillingAgreement operation. You will be able to get the new address using the

GetBillingAgreement operation only after you call the ConfirmBillingAgreement operation.

• The buyer will receive an e-mail from Amazon, similar to the email they receive when they update the payment method.

Simultaneous one time and automatic purchases

The Billing Agreement enables you to process payments for one-time as well as automatic purchases. For example, you might sell a book (one-time payment) along with a magazine subscription (for which a buyer will pay an amount each month for the next 24 months). If the buyer purchases both items, then the integration experience will be the same as described above. Once you have a Billing Agreement, you will be able to charge the buyer for both recurring payment and one-time purchases.

However, it is possible that at the last step of your checkout flow, the buyer changes his or her mind and does not want to purchase the insurance plan. In this case, it is likely that the buyer will not authorize automatic payments from the Authorize Automatic Payments widget. Therefore, you will not be able to confirm the Billing Agreement object in the Draft state. Under this circumstance, Login and Pay with Amazon enables you to create an Order Reference for a one-time purchase. To do so, call the CreateOrderReferenceForId operation and specify the value

of ConfirmNow parameter to be true. This operation will create and confirm the Order Reference with the payment

In document Gestión integral de las operaciones en una empresa minera (seguridad y salud ocupacional, medio ambiente, calidad) (página 92-95)