PayPal Sandbox User Guide
Contents
1. 5 Shipping so Apply tax to shipping ax Rate 00 Tax Amount 0 00 Total 5 00 Transaction Type Auth a Item Name Service L Order Number Billing Information Please enter the following information exactly as it appears on the customer s credit card statement Country United States First Name Last Name Card Type Visa Card Number 4011238251258087 za BE eg Expiration Date 01 2008 Sard Security Code gt On the back of your card locate the final 3 digit number What s this Using Amex Address Line 1 123 AVS_ASt Address Line 2 ay State Y ZIP Code Email Address Home Telephone Shipping Address No shipping address required Use the same above billing address as the shipping address Enter a separate shipping address When you attempt to process the transaction the following message appears PayPal Log Out Security Center Overview Add Funds History Profile Virtual Terminal Order Entry Form Secure Transaction f A 10555 This transaction cannot be processed Filter Decline e Processor Response Code 0000 AVS A Address only match e CW M Pass e Reference F10CC2B1F2B34 Testing an AVS Code Using DoDirectPayment Consider an example that sets up testing for AVS code A and error code 10755 in DoDirectPayment for which AVS co2. April 2012 43 ju Sandbox Test Tools Instant Payment Notification Simulator 44 April 2012 Sandbox User Guide Sandbox User Guide Testing Error Conditions In default operation the Sandbox mimics the live PayPal site as closely as possible which means that an error can be replicated only by creating the exact conditions and sequence of events to raise an error This positive test environment is well suited for testing logic that follows the typical error free path however it can be difficult to raise error conditions and test logic to handle errors The Sandbox can be set to allow negative testing which enables you to simulate an error You can test against the following kinds of errors e errors that result from calling a PayPal API e address verification and credit card validation errors that occur when using Virtual Terminal or calling DoDirectPayment IMPORTANT Negative testing is only available for Version 2 4 and later of PayPal APIs You raise an error condition by setting a value in a field passed to an API or setting a value in a field submitted to Virtual Terminal The value triggers a specific error condition Negative testing is available only in the Sandbox you cannot force or simulate an error on the live site You must create a Business test account and enable negative testing otherwise setting a value in the API or transaction will not raise an error unless the error would be raised in the default posit
3. Legend a Web Flow API Call Token a Re t rs E PayPal 2 Sandbox Response Token 3 PayPal Login L HTTP Redirect gt 4 l HTTP Redirect Confirm Details RetumURL Token mmm Continue amp 5 Confirm Order Request Token es GetExpressCheckoutDetails PayPal Sandbox Response Customer Details Request Final Transaction Details gt DoExpressCheckoutPayment PayPal Sandbox 4 Response Transaction Results Success Failure The following steps match the circled numbers in the diagram Perform the actions in each step to test Express Checkout 1 Invoke a form on your site that calls the SetExpressCheckout API on the Sandbox To invoke the API set form fields whose names match the NVP names of the fields you want to set specify their corresponding values and then post the form to a PayPal Sandbox server 36 April 2012 Sandbox User Guide Testing an Express Checkout Integration CEN such as https api 3t sandbox paypal com nvp as shown in the following example lt form method post action https api 3t sandbox paypal com nvp gt lt input type hidden name USER value API_username gt lt input type hidden name PWD value API_passwora gt lt input type hidden name SIGNATURE value API_signature gt lt input type hidden name VERS
4. TIMESTAMP 2007 2d04 2d05T23 3a30 3a16Z amp CORRELATIONID 333fb808bb23 amp ACK Success amp VERSION 2 2e300000 amp BUILD 1 2e0006 amp TOKEN EC 2d1NK66318YB717835M amp TRANSACTIONID 0431444401487742J amp TRANSACTIONTYPE expresscheckout amp PAYMENTTYPE instant amp ORDERT IME 2007 2d04 2d05T23 3a30 3a14Z amp AMT 19 32e95 amp CURRENCY CODE USD amp TAXAMT 0 2e00 amp PAYMENTSTATUS Pending amp PENDINGREASON authorization amp REASONCODE None Gl Gl Sandbox User Guide April 2012 39 FE Testing an Express Checkout Integration 40 April 2012 Sandbox User Guide Sandbox Test Tools Instant Payment Notification Simulator You can use the Instant Payment Notification IPN Simulator to send IPNs to the URL that you set up to receive them You can use this tool to verify that you are receiving IPNs correctly To set up and send an IPN select Instant Payment Notification IPN simulator from Test Tools You can enter the URL to receive the notification and the kind of notification on the following screen Sandbox Home Test Accounts 3 Test Email Instant Payment Notification IPN simulator API Credential PE reset Select from the transaction types supported to test the Instant Payment Notification IPN feature Test Tools Enter the URL of the webpage where you wish to receive IPNs and the transaction type for this test Can We Help General informatio
5. click Request Money This triggers the actual request for funds 11 Navigate to the My Account gt Overview tab The request for money should be listed 12 Log in as the buyer and navigate to the My Account gt Overview tab to see the transaction for the buyer s test account The transaction for the request for money appears on the My Account gt Overview tab with Pay and Cancel buttons Click Pay and in the confirmation window click Send Money This completes the transfer of requested funds To view the email messages sent to both test accounts select the Test Email tab For details about your Sandbox email see Test Email on page 12 Sandbox User Guide April 2012 33 ER Testing PayPal Website Features Billing A Customer 34 April 2012 Sandbox User Guide Sandbox User Guide Testing an Express Checkout Integration You can test your Express Checkout integration in the Sandbox This example shows how to simulate your web pages using HTTP forms and supplying the values for API operations from these forms You can use this strategy for your initial testing however for more complete testing you will want to replace these forms with your web pages containing actual code The following diagram shows the Express Checkout execution flow which uses the Sandbox as the API server The pages on the left represent your site April 2012 35 a Testing an Express Checkout Integration Express Checkout Execution Flow
6. C Wait Don t ship yet Payment Status Under Review What should I do now Seller Protection Not Eligible Wait to ship the item until we ve completed Payment Review for this transaction e To help protect you PayPal is reviewing this payment The review process may take up to 24 hours We ll contact you as soon as we reach a decision To remain eligible for Seller Protection you should not ship the itern until we let you know the payment has cleared Transaction Completed Unique Transaction ID 0AM784105N6596809 Name TestUser The sender of this payment is Verified Email kchalu_1228050167_per paypal cam Billing Agreement ID 8 9F S32506MB869970E Billing Description Payment Sent to kchalu_1227895647_biz paypal com View Billing Agreement Details April 2012 Sandbox User Guide Technical Support Depending on the PayPal product you need assistance with contact either Customer Service or Developer Technical Support Contacting Customer Service for Live PayPal Website Help Use PayPal Help to find an answer to any problem you might encounter with live products such as Website Payments or Instant Payment Notification To contact Customer Service about issues with the Live PayPal website 1 Go to https paypal com 2 Click Help in the upper right corner of the page 3 4 5 Click Contact Us in the lower left of the page Chose either Help by Email or Help by Phone Follow the remaining
7. Create Manually to create the test account manually The following sections assume that a test account has not yet been created Creating a Preconfigured Account To create a preconfigured account 1 After logging in select Test Accounts and click the Create Test Account link 2 Choose the country for which you want the account to be registered 14 April 2012 Sandbox User Guide Setting Up Test Accounts Managing Test Accounts Sandbox Home Test Accounts Test Email Create a Sandbox Test Account API Credentials After creating the account you can delete the account or you can provide additional information in Test Tools the Sandbox Test Site How to automatically create verified accounts Country PU i United States United Kingdom Australia Canada Customer Support France Germany Italy Netherlands Spain Additional resources Documentation PayPal Developer i f Community bresent your customer s experience present yourself as the merchant Developer Central paypal com only used inside the Sandbox 3 Specify the Account Type and make other selections or accept the defaults IMPORTANT When entering a value into the Login Email field you do not enter a complete email address rather you enter a prefix of up to 6 characters which will appear at the beginning of the email address PayPal creates an email address for you using an internal algorithm You cannot specify the comp
8. YourSandboxBuyerAccountEmail RID 7AKUSARZ7SAT8 RSTATUS verified Ra zal Ei amp COUNTRYCODE US PTOCOUNTRYCODE US PTOCOUNTRYNAME United 20States SHIPTOZIP 94666 amp ADDRESSID amp ADDRESSSTATUS Confirmed Rh n I H H H H H H HO y 3 Q Q H H i 6 Invoke a form on your site that invokes the DoExpressCheckout Payment API operation on the Sandbox lt form method post action https api 3t sandbox paypal com nvp gt lt input type hidden name USER value API_username gt lt input type hidden name PWD value API_password gt lt input type hidden name SIGNATURE value API_signature gt lt input type hidden name VERSION value 2 3 gt lt input type hidden name PAYMENTACTION value Authorization gt lt input type hidden name PAYERID value 7AKUSARZ7SAT8 gt lt input type hidden name TOKEN value EC 2d1NK66318YB717835M gt lt input type hidden name AMT value 19 95 gt lt input type submit name METHOD value DoExpressCheckoutPayment gt lt form gt 38 April 2012 Sandbox User Guide Testing an Express Checkout Integration 7 Review the response string from the DoExpressCheckoutPayment API operation If the operation was successful the response should include ACK set to Success as follows
9. certificates PayPal Merchant Features supported Completely fictitious Before you begin working with the Sandbox create the details for all the business roles you must fulfill The Sandbox simulates verification of postal addresses and names The Sandbox has a special purpose email inbox for your testing contained in the Sandbox itself The Sandbox creates bank accounts credit card numbers and CVV2 numbers you need in order to develop and test all of which are fictitious and only used within the Sandbox The Sandbox simulates the verification of these numbers Transactions do not affect real accounts and actual money is never exchanged 111 nn nnnn The Sandbox creates all fictitious bank accounts credit card numbers and CVV2 numbers you need for development and testing The Sandbox simulates the verification of these numbers Fraud detection is not enabled for the Sandbox After you request digital certificates for use with the PayPal Web Services API the Sandbox automatically generates them They are available for immediate downloading All features of the live PayPal website except closing an account auction features monthly statements shipping preferences and PayPal Shops Real companies and people s names and postal addresses Real email address and inbox for each business role Actual verification of bank account numbers credit card numbers and CVV2 numbers Real social security number
10. see Sandbox Test Tools on page 41 e Change the log in password using the Profile link NOTE You cannot change the Log In Email address Sandbox User Guide April 2012 11 Ir Accessing the PayPal Sandbox Test Email Test Email When certain kinds of transactions occur in the live PayPal system PayPal sends email messages to the real email addresses of the participants From these email messages the recipient or initiator of an event or transaction can verify that the event took place and that the monetary amounts associated with the event are correct PayPal test email however is a self contained email system in the Sandbox itself You see email messages addressed only to the Sandbox test accounts you set up Up to 30 of the latest email messages are listed on the Test Email tab The subject line of email messages you have not read are in bold Click a subject line to read the message 12 April 2012 Sandbox User Guide Setting Up Test Accounts Depending on the business application you are developing and testing you need different types of test accounts There are two types of test accounts Personal or Premier and Business Planning the Types of Test Accounts You Need Determine the types of test accounts you need to test the applications you are developing In addition determine the number of different accounts you need Typically you create at least one seller Business account and one buyer Personal or
11. 41933 33 amp Errors urn ebay apis eBLBaseComponents amp ShortMessage Buyer cannot pay amp LongMessage Transaction rejected please contact the buyer amp ErrorCode 10606 amp SeverityCode Error amp Negative Testing Using a Non Amount Trigger Field Consider an example that sets up testing for error 10603 for DoVoid in which the error code is specified in the AUTHORIZATIONID field ETHOD DoVoid amp AUTHORIZATIONID 10603 amp VERSION 2 4 amp USER usernames amp PWD passwords SIGNATURE signature The request invokes the following response TIMESTAMP 2007 2d04 2d04T03 3a10 3a22Z amp CORRELATIONID 51b0c5054dee6 amp ACK Failure amp L_ERRORCODE0 10603 amp L_SHORTMESSAGE0 The 20buyer 20is 20restricted 2e amp L_LONGMESSAGE0 The 20buyer 20account 20is 20restricted 2e amp L _SEVERITYCODEO Error amp VERSION 2 2e4000008 BUILD 1 2e0006 Negative Testing With Multiple Messages Consider an example that sets up testing for error 10009 for RefundTransaction which returns 14 possible error message sets ETHOD RefundTransactiong RANSACTIONID asdf UNDTYPE Partial amp AMT 100 09 amp ERSION 2 48 ER USemames D passwords SIGNATURE signature lt ay Ay ma n The request invokes the following response Sandbox User Guide April 2012 49 50 Testing Error Conditions Testing Using AVS Codes TIMESTAMP 2007 2d04 2d04T03 3
12. 5 2008 Payment To Gary McCue s Test Store Uncleared Details 10 00 USD Related Transaction Date al Type Status Details Amount Apr 25 2008 Add Funds from a Bank Account Uncleared KER 10 00 USD Date Apr 25 2008 Time 21 57 17 PDT Status Uncleared Expected Clearing Date Apr 30 2008 Funding Type eCheck Funding Source Chase Manhattan Checking Confirmed xxxxxx9243 a Transaction Transaction Eistumisites Verifying a Test Refund 1 Log in to https developer paypal com 2 Click the Test Email tab Your Sandbox inbox shows refund confirmation email messages for the seller and buyer 3 To further verify that the refund was successful Check your Web server for IPN notifications related to the refund Launch the Sandbox as your test buyer or seller account and navigate to My Account gt Overview to see the transaction in your Recent Activity 30 April 2012 Sandbox User Guide Testing PayPal Website Features ES Transferring Funds to a Test Account Transferring Funds to a Test Account To transfer funds to a test account 1 After logging into https developer paypal com select a test account and click Enter Sandbox Test Site 2 Navigate to My Account gt Add Funds 3 Click the Transfer funds from a Bank Account link 4 On the Add Funds by Electronic Funds Transfer page Select the bank account from which the funds are coming in the From drop down l
13. Features 27 Website Payments with Buy Now Button 27 Encrypted Website Payments 28 Testing Payments with Buy Now Button 28 Verifying a Test Payment eee eee ke kk kk en 28 Handling Pending Transactions aooaa a a 29 Sandbox User Guide April 2012 FR Contents Creating a Pending Transaction Completing or Canceling a Pending Transaction Verifying a Test Refund Transferring Funds to a Test Account Clearing or Failing Test eCheck Transactions Sending Funds to a Seller Billing A Customer Chapter 5 Testing an Express Checkout Integration Chapter 6 Sandbox Test Tools Instant Payment Notification Simulator Testing IPN Messages in the Sandbox Chapter 7 Testing Error Conditions API TOSUNG Soo eee A e Be Y Negative Testing Using an Amount Related Trigger Field Negative Testing Using a Non Amount Trigger Field Negative Testing With Multiple Messages Testing Using AVS Codes Testing an AVS Code Using Virtual Terminal Testing an AVS Code Using DoDirectPayment Testing Using CVV Codes Testin
14. ION value 2 3 gt lt input type hidden name PAYMENTACTION value Authorization gt lt input name AMT value 19 95 gt lt input type hidden name RETURNURL value http www YourReturnURL com gt lt input type hidden name CANCELURL value http www YourCancelURL com gt lt input type submit name METHOD value SetExpressCheckout gt lt form gt NOTE The API username is a Sandbox business test account for which a signature exists See the Test Certificates tab of the Sandbox to obtain a signature If you are not using a signature you must use a different Sandbox server 2 Review the response string from the SetExpressCheckout API operation PayPal responds with a message such as the one shown below Note the status which should include ACK set to Success and a token that is used in subsequent steps TIMESTAMP 2007 2d04 2d05T23 3a23 3a07Z amp CORRELATIONID 63cdac0b67b50 amp ACK Success amp VERS ION 2 2e300000 amp BUILD 1 2e0006 amp TOKEN EC 2d1NK66318YB717835M 3 If the operation was successful use the token and redirect your browser to the Sandbox to log in as follows https www sandbox paypal com cgi bin webscr cmd _express checkout token EC 1NK66318YB717835M You may need to replace hexadecimal codes with ASCII codes for example you may need to replace 2d in the token with a hyphen You must log in to https developer paypal com before you log in to
15. Pal site except that no real money changes hands Documentation PayPal Developer Test Accounts Community gt Create a preconfigured buyer or seller account Customer Support gt Create a Website Payments Pro account US UK Developer Central gt Manually create accounts Test Email Access email sent to your test accounts API Credentials Manage API credentials for your test accounts Test Tools Instant Payment Notification IPN simulator Fees Privacy Security Center Contact Us Legal Agreements User Agreement Copyright amp 1999 2009 PayPal All rights reserved On this page you can perform the following actions e Create test accounts You can create and manage test accounts from the Test Accounts tab From this tab you can also enter the Sandbox Test Site which simulates the live paypal com site For more information see Setting Up Test Accounts on page 13 e Access email sent to test accounts from the Test Email tab For more information see Test Email on page 12 e View API credentials for business test accounts from the API Credentials tab An API signature which is the preferred kind of credential is automatically created when you create a Business test account You need the information on this tab when you test APIs e Obtain technical information about PayPal products and APIs using the Help link e Simulate Instant Payment Notifications using a test tool For more information
16. PayPal Sandbox User Guide PayPal Sandbox User Guide Document Number 100008 en_US 201204 2012 PayPal Inc All rights reserved PayPal is a registered trademark of PayPal Inc The PayPal logo is a trademark of PayPal Inc Other trademarks and brands are the property of their respective owners The information in this document belongs to PayPal Inc It may not be used reproduced or disclosed without the written approval of PayPal Inc Copyright PayPal All rights reserved PayPal S r l et Cie S C A Soci t en Commandite par Actions Registered office 22 24 Boulevard Royal L 2449 Luxembourg R C S Luxembourg B 118 349 Consumer advisory The PayPal payment service is regarded as a stored value facility under Singapore law As such it does not require the approval of the Monetary Authority of Singapore You are advised to read the terms and conditions carefully Notice of non liability PayPal Inc is providing the information in this document to you AS IS with all faults PayPal Inc makes no warranties of any kind whether express implied or statutory with respect to the information contained herein PayPal Inc assumes no liability for damages whether direct or indirect caused by errors or omissions or resulting from the use of this document or the information contained in this document or resulting from the application or use of the product or service described herein PayPal Inc reserves the right to
17. PayPal Payments Standard Integration Guide 5 Copy and paste the code into your web page file wherever you would like the button image to appear Typically the button should be located next to the description of the item or service Your web page does not have to be published to your web server for you to check the button placement it can be on you own local hard drive Sandbox User Guide April 2012 27 28 Testing PayPal Website Features Website Payments with Buy Now Button IMPORTANT You must change the form action to redirect to the Sandbox using the following URL https www sandbox paypal com cgi bin webscr method post Use the PayPal Help link to answer related questions such as How do I make a Buy Now Button compatible with the Shopping Cart feature For general information see https www paypal com pdn item For general information about shopping cart purchases see https www paypal com shoppingcart For general information about subscriptions see https www paypal com pdn recurring Encrypted Website Payments The Sandbox also supports Encrypted Website Payments EWP as does the PayPal SDK console For information about what EWP is and how to use it see the Paypal Payments Standard Integration Guide Testing Payments with Buy Now Button For the purposes of testing the Buy Now button your web page does not need to be published to your web server It can reside on your local hard drive How
18. Premier account You might need several different Personal or Business PayPal test accounts to test your application When you create a test account the following information is generated for you e Mailing address e Email address and password for the test PayPal account You can specify the same password not email address for all your test accounts so that you can more easily remember it e Security questions and answers You can use the same security questions and answers for all your test accounts so that you can more easily remember them IMPORTANT Never use real email addresses or live paypal com passwords for a test account Only use fictitious information in your answers to the security questions All of this data should be fictional e Personal or Business account e Your agreement to the terms of using the Sandbox For Business accounts the following additional information is generated for you e Business name and address e Customer service contact information e Business owner contact information e Business owner address e Social Security Number to sign up for PayPal Payments Pro previously known as Website Payments Pro Sandbox User Guide April 2012 13 El Setting Up Test Accounts Managing Test Accounts Managing Test Accounts You can view work with or launch the Sandbox Test Site for all your test accounts You can also create new accounts or remove test email addresses from your view e To work with t
19. a Sandbox test account You then log in to the test account that represents the buyer not the API_username business test account that represents you as the merchant 4 After logging into the buyer test account confirm the details When you confirm the Sandbox redirects your browser to the return URL you specified when invoking the SetExpressCheckout API operation as in the following example http www YourReturnURL com token EC 1NK66318YB717835M6PayerID 7AKUSARZ7SAT8 Sandbox User Guide April 2012 37 Br Testing an Express Checkout Integration 5 Invoke a form on your site that calls the GetExpressCheckoutDetails API operation on the Sandbox lt form method post action https api 3t sandbox paypal com nvp lt input type hidden name USER value API username gt lt input type hidden name PWD value API_passwora gt lt input type hidden name SIGNATURE value API_signature gt lt input type hidden name VERSION value 2 3 gt lt input name TOKEN value EC 1NK66318YB717835M gt lt input type submit name METHOD value GetExpressCheckoutDetails gt lt form gt E If the operation was successful the GetExpressCheckoutDetails API returns information about the payer such as the following information TIMESTAMP 2007 2d04 2d05T23 3a44 3al1Z amp CORRELATIONID 6b174e9bac3b3 amp ACK Success amp VERS ION 2 32e300000 amp BUILD 1 2e0006 amp TOKEN EC 2d1NK66318YB717835M
20. a mismatch in the card validation code METHOD DoDirectPayment amp CREDITCARDTYPE VISA amp ACCT 4683075410516684 amp EXPDATE 112007 amp CVV2 1168 AMT 1 55 FIRSTNAME Designer LASTNAME Fotos TPADDRESS 255 55 167 0028 STREET 1234 20EasyS20Streetg CITY San 20Jose amp STATE CA amp COUNTRY United 20States ZIP 95110 amp COUNTRYCODE US amp HIPTONAME Louise 20P 20Flowerchild amp HIPTOSTREET 1234 20Easy 20Street amp HIPTOSTREET2 Apt 2022 20bis amp HIPTOCITY New S200rleans amp HIPTOSTATE LA amp HIPTOCOUNTRY US amp HIPTOZIP 70114 amp PAYMENTACTION Authorization FIZBIN f00 VERSION 2 48 USER UuSemames PWD passwords SIGNATURE signature NNNnNnNnNnNN NWN Sandbox User Guide April 2012 55 Testing Error Conditions Testing Using CVV Codes The request invokes the following response TIMESTAMP 2007 2d04 2d04T0353a355 3a12Z8 CORRELATIONID 2499856319532 amp ACK Failure amp L_ERRORCODE0 15004 amp L_SHORTMESSAGE0 Gateway 20Decline amp L_LONGMESSAGEO This 20transaction 20cannot 20be 20processed 2e 20Please 20e nter 20a 20valid 20Credit 20Card 20Verification 20Number 2e amp L_SEVERITYCODEO Error amp VERS ION 2 2e400000 amp BUILD 1 2e0006 56 April 2012 Sandbox User Guide Testing Payment Review On the live site payment review is always active which means that PayPal reviews payments automatically for various risk factors In the Sandbox all transac
21. a10 3a23Z amp CORRELATIONID 81cccl8eaec49 amp ACK Failure amp L_ERRORCODE0 10009 amp L_SHORTMESSAGE0 Transaction 20refused amp L_LONGMESSAGE0 You 20can 20not 20refund 20this 20type 200f 20transaction amp L_SEVERITYCODEO Error amp L_ERRORCODE1 10009 amp L_SHORTMESSAGE1 Transact ion 20refused amp L_LONGMESSAGE1 You 20are 200ver 20theS20time 201imit 20to 20perform 20a 20r efund3200n 20this 20transaction amp L_SEVERITYCODE1 Error amp L_ERRORCODE2 10009 amp L_SHORTMESSAGE2 Transaction 20refused L_LONGMESSAGE2 Account 20is 20restricted amp L_SEVERITYCODE2 Error amp L_ERRORCODE13 10009 amp L SHORTMESSAGE13 Transaction 20refuseds L_LONGMESSAGE13 The 20partial 20refund 20amount 20must 20be 201ess 20than 2 Oor 20equal 20to 20the 20remaining 20amount amp L_SEVERITYCODE13 Error amp VERS ION 2 2e400000 amp BUILD 1 2e0006 Testing Using AVS Codes You can simulate address verification by triggering an AVS error code when you call DoDirectPayment or use Virtual Terminal To specify a code place AVS_code in the NVP STREET field or the Street1 SOAP element when you call DoDirectPayment where code is an AVS code or enter AVS_code in Address Line 1 when using Virtual Terminal For example if you set 123 AVS_A Street in the NVP STREET field AVS code Ais set NOTE AVS code is case sensitive all characters must be uppercase For example AVS_A is valid trigger avs_a is not The f
22. al Bank Accounts on page 23 You can add bank accounts but they will not contain funds unless you use Send Money to send the bank account holder money 2 Adding Credit Cards on page 24 For testing this is the most efficient way to add funds NOTE No money or funds are actually transferred in the Sandbox however to protect confidentiality you should not use actual credit card numbers or bank accounts if you allow other people to log in to your Sandbox account Changing or Adding Additional Bank Accounts You add a bank account to the Sandbox test account representing a customer or buyer so that you can test transactions between the buyer s account and another account typically the other account is a business account that represents yourself as a merchant Adding a bank account also changes the account status from Unverified to Verified The bank account is a source of funds for a user s PayPal account and thus for transactions between that test account and other test accounts A test account can have multiple bank accounts but at least one is required in order to verify the test account The Sandbox automatically generates bank account and sort code numbers when you add a bank account For Australia Canada Germany or UK use the automatically generated bank account information only for test US bank accounts To add test Canadian German or UK bank account information follow these guidelines Aus
23. ary to test UK accounts in Sandbox Proper Sort Code is 609204 December 2005 Miscellaneous corrections April 2012 61 Sandbox User Guide 62 April 2012 Sandbox User Guide
24. as the merchant Login Email seller_1198117529_biz live com This email address is only used inside the Sandbox 198117748 Add Credit Card Visa Add Bank Account Yes Account Balance 0 00 USD E Hide Advanced Options Rerun test April 2012 19 20 Setting Up Test Accounts Managing Test Accounts After you reset the account the information to rerun your test is preserved Log in email seller_1198117529_biz li ve com El Hide Details Business Name Credit Card Bank Account Balance Email Notes Date Reset Test Account Test Account seller_1198117529_biz live com Type Country Status Test mode Reset Business United States Verified Disabled Reset Gary McCue s Test Store Visa 4641631486853053 Exp Date 12 2017 Checking Confirmed Routing Number 325272034 Bank Account Number 848726650957846 0 00 USD Confirmed Rerun test Dec 19 2007 18 30 53 PST Date Created Dec 19 2007 18 30 53 PST API Username seller_1198117529_biz_apil live com API Password 1198117541 Signature AWYUjIOmqYJ9hjSc4XD9v4tF7TtGAmKfSL2cHk63ScnSIXIGiKoCVWx Creating a Test Account Manually You can create a test account manually by clicking the Create Manually link for Create Account This action automatically places you in the Sandbox Test Site where you create the test account just as you would on the live site April 2012 Sandbox User Guide Setting Up Test Accounts Eu Creati
25. cation Simulator Basic information business seller paypalsandbox com receiver email 51 receiver_id TESTSELLERID1 residence_country US Se quantity 1 shipping 3 04 tax 2 02 Currency and currrency exchange me currency USD US Dollars v me_fee 0 44 mc gross 12 34 Transaction fields txn type web accept txn id 12518655 parent txn id EARLIERTRANSIDO01 notify version 2 1 Refunds reversals reason code refund Advanced and custom information custom xy2123 Show all fields EL Cancel You can modify the fields that you want to include in the IPN however the simulator does not check the validity of any field that you change NOTE By default only populated fields are displayed You can check the Show all fields box to view all fields After you have viewed or modified the fields to be sent click Send IPN The results of the operation are displayed at the top of the page Testing IPN Messages in the Sandbox Sandbox User Guide After you use the IPN simulator you should test actual notifications in the Sandbox as well The only difference between a test IPN message and a live IPN message is that PayPal includes a test_ipn variable in the IPN message To set up your Sandbox account to handle IPNs outside of the test tool click Enter Sandbox Test Site from your test account and proceed as if you are using a live account See Instant Payment Notification Guide for more information
26. count to represent a buyer To simulate an action on the live site PayPal com Customer Support Setting Up Test Accounts Managing Test Accounts Test Email Test Accounts API Credentials You have successfully created a test account You can view email for this account on the Test Email tab Additional resources Documentation Your test accounts are listed below You must have a Business account to represent a merchant select a test account and click Enter Sandbox Test Site Developer Central Create Account Preconfigured Create Manually Website Payments Pro US UK A A A Negative Log in Email Payment Review Test Mode Reset TestSB_1254900954_biz paypal com Disabled Disabled Reset Business verified D View Details Ente Sandor Test Site Dele NOTE The Login Email is a pseudo randomized address which is based on the address you specified Credit card and bank account numbers are also generated randomly which are shown when you view details April 2012 17 Setting Up Test Accounts Managing Test Accounts Sandbox Home Test Accounts Test Email Test Accounts API Credentials Test Tools fa You have successfully created a test account You can view email for this account x J on the Test Email tab Additional resources Documentation PayPal Developer Your test accounts are listed below You must have a Business account to represent a merchant Community and a Personal account
27. ctions concerning API testing and negative testing October 2010 Added a chapter about linking Sandbox accounts of x com accounts July 2010 Added additional information about the use of the email address field when creating preconfigured accounts October 2009 Added information about creating preconfigured accounts which now works for more countries Removed chapter about Testing Recurring Payments because it 1s no longer relevant September 2008 Added information about testing payment review and updated screens related to payment review April 2008 Added information about the Instant Payment Notification simulator described changes to the Sandbox user interface and corrected all known problems December 2007 Added information about the account reset feature changed screens to reflect changes in the user interface and corrected all known problems September 2007 Changed screens to reflect new user interface added information about testing recurring payments and corrected all known problems August 2007 Changed PayPal logo and corrected all known problems May 2007 Revised manual to reflect new autocreated accounts feature April 2007 Added chapters on negative testing and testing APIs using the Express Checkout NVP API Added new section on handling pending transactions and made miscellaneous changes July 2006 Correction of variable name ipn_test which should be test ipn June 2006 Correction of Sort Code necess
28. d Live PayPal This is an at a glance view of the differences from the perspective of an in house or third party developer for a business You can also use this table as a checklist PayPal Sandbox Live PayPal Website and API Service Type of PayPal Accounts Site logos in upper left corner NVP API Servers SOAP API Servers Business roles Depending on the feature you want to develop and test you need a Personal Business or Premier account https www sandbox paypal com PayPal https api sandbox paypal com nvp https api sandbox paypal com 2 0 You fill all roles you need to test merchant buyer and seller Personal Business or Premier account https www paypal com PayPal For API Certificate security https api paypal com nvp For API Signature security https api 3t paypal com nvp For API Certificate security https api paypal com 2 0 For API Signature security https api 3t paypal com 2 0 Real world people fill these roles Sandbox User Guide April 2012 Overview to the PayPal Sandbox At a Glance Differences between the Sandbox and Live PayPal PayPal Sandbox Live PayPal Website and API Service Company and people s names and postal addresses Email addresses and email inboxes Bank account and credit card numbers Social Security Number for Billing Agreements PayPal transactions Fraud detection Digital
29. de A indicates no zip code is specified and results in an error if the Partial Address Match risk control is set whether or not other errors occur April 2012 Sandbox User Guide Testing Error Conditions Testing Using CVV Codes ETHOD DoDirectPayment amp CREDITCARDTYPE VISA amp ACCT 4683075410516684 amp EXPDATE 112007 amp CVV2 808 amp AMT 107 55 amp FIRSTNAME Designer amp LASTNAME Fotos IPADDRESS 255 55 167 002 amp STREET 1234 20AVS_A 20Street CITY San 20Jose amp STATE CA amp COUNTRY United 20States amp ZIP 95110 amp COUNTRYCODE US amp SHIPTONAME Louise 20P 20Flowerchilds amp SHIPTOSTREET 1234 320Easy 20Street amp SHIPTOSTREET2 Apt 2022 20bis amp SHIPTOCITY New 200rleans amp SHIPTOSTATE LA amp SHIPTOCOUNTRY US amp SHIPTOZIP 70114 amp PAYMENTACTION Authorization FIZBIN foo amp VERSION 2 48 USER usernames PWD passwords SIGNATURE Aq9tJJ3ndj7r32JgX gAzqOoC1lJUJAM7erWun CUZYFDt xf fpKWU4EROG The request invokes the following response TIMESTAMP 2007 2d04 2d04T03 3a35 3al0Z amp CORRELATIONID a7cbf2d4d83dc amp ACK Failure amp L_ERRORCODE0 10555 amp L_SHORTMESSAGE0 Filter 20Decline amp L_LONGMESSAGEO This 20transaction 20cannot 20be 20processed 2e amp L_SEVERITYCODEO Error amp L_ERRORCODE1 10755 amp L_SHORTMESSAGE1 Unsupported 20Curr
30. dress results in an error if the No Address Match risk control is set E AVS_E Not allowed for MOTO internet phone transactions I AVS_I Service unavailable internationally results in an error if the Service Unavailable Unsupported risk control is set G AVS_G Service globally unavailable results in an error if the Service Unavailable Unsupported risk control is set R AVS_R Retry results in an error if the Service Unavailable Unsupported risk control is set S AVS_S Service not supported results in an error if the Service Unavailable Unsupported risk control is set U AVS_U Service unavailable results in an error if the Service Unavailable Unsupported risk control is set NOTE The specified AVS code is set regardless of whether a PP API error code is set If no AVS code is specified or the AVS risk control is not specified AVS code X is returned Testing an AVS Code Using Virtual Terminal Consider an example of testing for AVS code A using Virtual Terminal You enter AVS_A in the Address Line 1 field Sandbox User Guide April 2012 51 Testing Error Conditions Testing Using AVS Codes ATRAPAR ARPA SG ARR RO IRI My Account Send Money Request Money Merchant Services Overview Add Funds History Profile Virtual Terminal Order Entry Form Secure Transaction indicates required fieldsHide optional fields Order Details Currency Net Order Amount
31. ency 2e amp L_LONGMESSAGE1 This 20transaction 20cannot 20be 20processed 20due 20to 20an 20unsupported 20currency 2e amp L_SEVERITYCODE1 Error amp VERSION 2 2e400000 amp BUILD 1 2e0006 Testing Using CVV Codes You can simulate credit card validation by triggering a CVV error code when you call DoDirectPayment or use Virtual Terminal To specify a CVV code place a trigger value in the NVP CVV2 field or the CVV2 SOAP element when you call DoDirectPayment or enter the trigger in Card Security Code when using Virtual Terminal Sandbox User Guide April 2012 53 Testing Error Conditions Testing Using CVV Codes The following table identifies valid CVV codes corresponding triggers and a description of each error condition CVV Code Trigger Description of Error M 115 CVV2 matches no error N 116 CVV2 does not match U 125 Service unavailable S 123 Service not supported P 120 Transaction not processed X 130 No response NOTE The specified CVV2 code is set regardless of whether a PP API error code is set If no CVV2 code is specified Mis returned Virtual Terminal only displays the CV V2 error 1f the risk control blocks the payment Testing a CVV Code Using Virtual Terminal Consider an example of testing for CVV code N using Virtual Terminal You enter 116 in the Card Security Code field PayPal Log Out Security Center Overview Add Funds History Profile Virtual Terminal Orde
32. error occurring Negative Testing Using an Amount Related Trigger Field Consider an example that sets up testing for error 10623 for DoAuthorization in which the error code is specified in the AMT field ETHOD DoAuthorization TRANSACTIONID 0 1GU0288989807143Bg8 AMT 106 23 amp TRANSACTIONENTITY Order amp VERSION 2 4 amp USER usernames amp PWD passwords SIGNATURE signature The request invokes the following response TIMESTAMP 2007 2d04 2d04T03 3a10 3al 9Z amp CORRELATIONID 447d121150529 amp ACK Failure amp L_ERRORCODE0 10623 amp L_SHORTMESSAGE0O Maximum 20number 200 20authorization 20allowed 20for 20the 200rder 20is 20reached 2e amp L_LONGMESSAGEO Maximum 20number 200 20authorization 20allowed 20for 20the 200rder 20is 20reached 2e amp L_SEVERITYCODEO Error amp VERS ION 2 2e400000 amp BUILD 1 2e0006 Here is an example that sets up testing for error 10606 for DoReferenceTransaction in which the error code is specified in the SOAP OrderTotal field Method DoReferenceTransact ionReferenceID B 8GP9699385999711K amp PaymentAct ion Authorization Payment Type Any amp OrderTotal 106 06 TtemTotal 106 06 amp Quantity 1 amp Amount currencyID USD 106 06 amp 48 April 2012 Sandbox User Guide Testing Error Conditions API Testing The request invokes the following response Timestamp 2011 06 13T16 13 07Z Ack Failure amp CorrelationID bacbc
33. est accounts log in to https developer paypal com and click the Test Accounts tab e To create a new account click the Create Account link e To work with the account select the account by clicking the radio button associated with it on the left You can simulate the live paypal com site for the selected account by clicking Enter Sandbox Test Site When you logged in to https developer paypal com you might have set the Log me in automatically checkbox to allow direct access to https www sandbox paypal com in which case you do not have to launch the Sandbox to access it IMPORTANT The Delete button does not delete the test account It removes the test account from your list of accounts but the email address for the test account is still on file for the Sandbox You cannot reuse an email address that is still on file for the Sandbox If you want to rerun a test do not delete the account you can use the Reset option instead The following sections describe how to create a preconfigured test account which allows merchants to create an account using a typical configuration that is useful for most testing You can also create a test account manually which might be required if the preconfigured test account is not adequate for your needs NOTE The first test account that you create is always a preconfigured test account After you create the first account you click Preconfigured to create a preconfigured test account or
34. ever you do need to be logged in to the Sandbox 1 an Bb amp N Log in to https developer paypal com click the Test Accounts tab select the desired test account and click Enter Sandbox Test Site Open the HTML file containing the Buy Now Button Click the Buy Now Button Log in using your test buyer account Follow the on screen instructions to complete your test payment Verifying a Test Payment 1 2 Log in to https developer paypal com and click the Test Email tab Your Sandbox inbox shows payment confirmation email messages for the seller and buyer To further verify that the payment was successful Check your web server for IPN notifications related to the payment Launch the Sandbox as your test buyer or seller account and navigate to My Account gt Overview to see the transaction in your Recent Activity April 2012 Sandbox User Guide Testing PayPal Website Features Handling Pending Transactions Handling Pending Transactions Transactions typically are credited to your PayPal account instantly after the buyer completes the transaction however a buyer might select a payment method that is not completed instantly In these cases the transaction goes into a pending state and the transaction is completed after a couple of days The following sections describe how to set up pending status transactions that can either be completed or canceled Creating a Pending Transactio
35. g a CVV Code Using Virtual Terminal Testing a CVV Code Using DoDirectPayment Chapter 8 Testing Payment Review Chapter 9 Technical Support Contacting Customer Service for Live PayPal Website Help Contacting Developer Technical Support for API Help Revision History 4 April 2012 Sandbox User Guide Preface This document describes the PayPal test environment called the Sandbox Intended Audience This document is written for merchants and developers who want to test their PayPal based applications before using them in production Documentation Feedback Help us improve this guide by sending feedback to documentat ionfeedback paypal com Sandbox User Guide April 2012 en Documentation Feedback 6 April 2012 Sandbox User Guide Overview to the PayPal Sandbox The PayPal Sandbox is a self contained environment within which you can prototype and test PayPal features and APIs The PayPal Sandbox is an almost identical copy of the live PayPal website Its purpose is to give developers a shielded environment for testing and integration purposes and to help avoid problems that might occur while testing PayPal integration solutions on the live site Before moving any PayPal based application into production you should test the application in the Sandbox At a Glance Differences between the Sandbox and Live PayPal The following table compares the Sandbox an
36. gers PP API error code 10755 ExpressCheckout TOKEN Token Specify the error code to trigger as all Details digits in the field for example a token value of 10755 triggers PP API error code 10755 April 2012 Sandbox User Guide Testing Error Conditions API Testing API Name NVP Field Name SOAP Element Description Dol ExpressCheckoutP ayment Dol ExpressCheckoutP ayment November 2011 DoCapture DoVoid DoReauthorization DoAuthorization MassPay BillUser BAUpdate Version 2 4 TOKEN AMT or PAYMENTRE n_AMT AMT AUTHORIZATIONID AMT AMT QUEST __ Token OrderTotal Amount AuthorizationID Amount Amount EMAILSUBJECT AMT PID EmailSubject Amount MpID Specify the error code to trigger as all digits in the field for example a token value of 10755 triggers PP API error code 10755 Specify the error code to trigger as all digits in a number with two digits to the right of the decimal point for example 106 23 triggers PP API error code 10623 Specify the error code to trigger as all digits in a number with two digits to the right of the decimal point for example 106 23 triggers PP API error code 10623 Specify the error code to trigger as all digits in the field for example an ID of 10623 triggers PP API error code 10623 Specify the error code to trigger as all dig
37. hant account and gateway plus much more Customers shop and pay with credit cards directly on your website What are the steps to apply 1 Complete application approx 20 min N What do I need to know Account Use your existing account or create a new one Information Social Security number of owner or federal tax I D number Sales data e g average monthly volume Review Confirm your selection of product and services Billing Provide credit card information Approval process We ll review your application and notify you within 2 business days with your status Upon approval you can integrate and start receiving payments provided you have a functioning business website Pricing 30 monthly fee e 2 2 2 9 0 30 USD per transaction Integration Requires a pre integrated cart or an experienced web developer Learn more To complete the application for PayPal Payments Pro you must enter a Social Security Number You can enter a Social Security Number in the following format 111x000 where x is any digit NOTE The SSN you enter must not have already been recorded for some other account in the Sandbox April 2012 Sandbox User Guide Setting Up Test Accounts Adding a Funding Source Adding a Funding Source To test transactions you must add a source of funds to your buyer test account The following sections describe your choices 1 Changing or Adding Addition
38. instructions Contacting Developer Technical Support for API Help Sandbox User Guide For information about PayPal Web Services API Developer Central and using the Sandbox refer to the following resources Help Center In Developer Central click Help Center to access developer manuals and links Forums In Developer Central click Forums to share information with the PayPal developer community Online Developer Support Portal at https paypal com mts Use the Forums first to find answers about any questions or problems you might have Another developer might have already posted information about your question or problem To contact Developer Technical Support about the PayPal Web Services API 1 2 Log in to https developer paypal com by entering your email address and password in the Member Log In box Click Help Center at the bottom of the box on the right side of the page April 2012 59 FE Technical Support Contacting Developer Technical Support for API Help 3 Click Email PayPal Support 4 Complete the form 60 April 2012 Sandbox User Guide Revision History Revision history for PayPal Sandbox User Guide Date Description April 2012 Removed obsolete chapter Linking Your Sandbox with Your X com Account Updated references to Website Payments Standard and Website Payments Pro to PayPal Payments Standard and PayPal Payments Pro respectively December 2011 Added corre
39. is a source of funds for the buyer s PayPal account and thus can be used for transactions between a buyer s test account and other test accounts A test account can have multiple credit cards Test credit card numbers cannot be used to pay for real world transactions To create additional credit card accounts for an already existing test account Yn wn Bw D p Select a buyer s test account and click Enter Sandbox Test Site Navigate to My Account gt Profile Under the Financial Information header click the Credit Cards link In the Credit Cards window click the Add button In the Add Credit Card window leave the automatically generated information as is Make a note of the credit card number for your use in later testing Click Add Credit Card Generating a Credit Card Number to Test PayPal Account Optional To obtain a test credit card number for testing PayPal Account Optional 1 Select a buyer s test account and click Enter Sandbox Test Site April 2012 Sandbox User Guide Setting Up Test Accounts So Adding a Funding Source 2 Navigate to My Account gt Profile 3 Under the Financial Information header click the Credit Cards link Make a note of the credit card number for your use in later testing Sandbox User Guide April 2012 25 FE Setting Up Test Accounts Adding a Funding Source 26 April 2012 Sandbox User Guide Testing PayPal Website Features This chapter describes PayPal p
40. ist Enter the amount to transfer in the Amount box Click Continue 5 On the resulting Add Funds Confirmation page click Submit Navigate to My Account gt Overview to see that the transfer transaction is listed Clearing or Failing Test eCheck Transactions When you use eCheck to transfer funds or send payments the transaction appears as pending until you manually clear or fail it Manual clearing is only necessary in the Sandbox To clear or fail test eCheck transactions 1 In the transactions log click the Details link in the Details column 2 In the Transaction Detail window there are two links to simulate actual bank clearing These links appear only in the Sandbox Clear Transaction Click to complete the transaction Fail Transaction Click to cancel the transaction 3 Click Return to Log to see the transfer completed and the money in the Sandbox account The My Account gt Overview page opens 4 Click the View Limits links on the My Account gt Overview page to see the spending limits for the current test account For an alternative example see Completing or Canceling a Pending Transaction on page 29 Sandbox User Guide April 2012 31 32 Testing PayPal Website Features Sending Funds to a Seller Sending Funds to a Seller To purchase goods or services a PayPal user must send funds to a seller In the PayPal Sandbox you can simulate the actions of a buyer by manually i
41. its in a number with two digits to the right of the decimal point for example 106 23 triggers PP API error code 10623 Specify the error code to trigger as all digits in a number with two digits to the right of the decimal point for example 106 23 triggers PP API error code 10623 Specify the error code to trigger as all digits in the field for example a subject of 10755 triggers PP API error code 10755 Specify the error code to trigger as all digits in a number with two digits to the right of the decimal point for example 107 55 triggers PP API error code 10755 Specify the error code to trigger as all digits in the field for example an ID of 10755 triggers PP API error code 10755 Sandbox User Guide April 2012 47 Testing Error Conditions API Testing API Name NVP Field Name SOAP Element Description BAUpdate REFERENCEID ReferenceID Specify the error code to trigger as all Version 3 0 digits in the field for example an ID of 10755 triggers PP API error code 10755 DoReferenceTransac AMT OrderTotal Specify the error code to trigger as all tion digits in a number with two digits to the right of the decimal point for example 107 55 triggers PP API error code 10755 AddressVerify Not supported for negative testing NOTE If the trigger value is not a valid error code for the API being tested positive testing occurs for the request which might result in another
42. ive test environment To enable negative testing set Test Mode to Enabled The following screen shows two Business accounts The first test account enables negative testing the second account disables negative testing o Home y Sandbox Test Certificates Email Forums Help Center ie ries Sandbox The Sandbox is a safe testing environment where you can test PayPal payments and API calls The Sandbox is a mirror of the real PayPal site except that real financial transactions are not made Learn More 0 00 USD Yes Unverified Enabled Business us U S O Business us U S Sp Yes Unverified Disabled i i To test Virtual Terminal you must set risk controls for address verification and credit card security respectively to Decline or Accept and Report depending on the kind of negative testing you want to perform If you do not set the appropriate risk controls default processing occurs which is to accept the transaction Severe error conditions such as bad arguments or invalid login preempt negative testing because the error cannot be handled by either negative testing or positive testing In these April 2012 45 46 Testing Error Conditions API Testing cases the error condition for positive testing is raised regardless of whether the account was enabled for negative testing API Testing For APIs you trigger an error condition by setting a field to the value of the error you want to trigger The val
43. lete email address For example if you specified test01 in the Login Email field the email address which is only used in the Sandbox would be something like test01_1279824359 pertadomain com Sandbox User Guide April 2012 15 Setting Up Test Accounts Managing Test Accounts PayPal box Help Profile Log Out Sandbox Home Test Email Create a Sandbox Test Account API Credentials After creating the account you can delete the account or you can provide additional information in Test Tools the Sandbox Test Site How to automatically create verified accounts Country Additional resources United States Y Documentation Account Type PayPal Developer E Community O Buyer Use to represent your customer s experience O seller Use to represent yourself as the merchant Customer Support Developer Central Login Email paypal com This email address is only used inside the Sandbox Password Your password must be at least 8 characters Add Credit Card Wisa M Add Bank Account O ves O no Account Balance 10 00 USD Notes ECreateccounts Cancel Fees Privacy Security Center Contact Us Legal Agreements User Agreement d 4 Click Create Account The result is shown below April 2012 Sandbox User Guide Sandbox User Guide Sandbox Home Test Accounts Test Tools PayPal Developer Community and a Personal ac
44. make changes to any information herein without further notice Contents Preface 1 me emne lt lt 0 lt 4 lt 0 0 lt B Intended Audience 4 444440 ee en 5 Documentation Feedback 4 5 Chapter 1 Overview to the PayPal Sandbox 7 At a Glance Differences between the Sandbox and Live PayPal 7 Chapter 2 Accessing the PayPal Sandbox 9 Signing Up for Sandbox Access 9 Welcome to the PayPal Sandbox 11 Test Email sucesos ra soma ae mn a dus feb de amp 12 Chapter 3 Setting Up Test Accounts re 13 Planning the Types of Test Accounts You Need 13 Managing Test Accounts 14 Creating a Preconfigured Account 14 Verified Account Status 18 Resetting a Preconfigured Account 18 Creating a Test Account Manually 20 Creating a PayPal Payments Pro Account 21 Adding a Funding Source eee keen ke 23 Changing or Adding Additional Bank ACCOUNTS 23 Adding Credit Cards 24 Generating a Credit Card Number to Test PayPal Account Optional 24 Chapter 4 Testing PayPal Website
45. n 1 Log in to https developer paypal com click the Test Accounts tab select a buyer personal or premier test account and click Enter Sandbox Test Site 2 Log in to your test buyer account and create a transaction such as one created using a Buy Now button or by passing parameters in the URL as in the following example https www sandbox paypal com us cgi bin webscr cmd _xclick amp business seller domain com 3 On the Review Purchase Page click on the link Change under funding method 4 Select eCheck as the funding method and click Continue 5 Click Pay to create the transaction To verify the creation of the transaction see Verifying a Test Payment on page 28 Completing or Canceling a Pending Transaction 1 In the buyer s transactions log click the Details link in the Details column 2 In the Transaction Detail window there are two links to simulate actual bank clearing These links appear only in the Sandbox as shown below Clear Transaction Click to complete the transaction Fail Transaction Click to cancel the transaction Sandbox User Guide April 2012 29 ER Testing PayPal Website Features Verifying a Test Refund My Account Send Money Request Money Merchant Services Overview Add Funds History Profile Transaction Details Add Funds from a Bank Account ID 2T856487XV899364R Original Transaction Date Type Status a Details a OMIT Apr 2
46. n Visit the PayPal Developer a E to integration questions or select v to file a support ticket select eCheck pending eCheck complete eCheck declined Express Checkout Cart checkout Web Accept Refund eBay checkout Reversal Canceled reversal Send 141 Cancel When you select the kind of transaction that you want to test a form containing test data appears Sandbox User Guide April 2012 41 42 Sandbox Test Tools Instant Payment Notification Simulator PayPal and Help Profile Log Out an ox Sandbox Home Test Accounts Test Email Instant Payment Notification IPN simulator API Credentials Select from the transaction types supported to test the Instant Payment Notification IPN feature Enter the URL of the webpage where you wish to receive IPNs and the transaction type for this test Can We Help General information Visit the PayPal Developer to file a support ticket Default values provided in the fields below are valid You may change any of these values but your changed values will not be validated Payment information payment_type O echeck O instant payment_date 23 55 12 May 16 2008 PDT payment_status Refunded Mi Buyer information payer_status unverified O verified last_name payer_email payer_id TESTBUYERIDOL April 2012 Sandbox User Guide Sandbox Test Tools Instant Payment Notifi
47. ng a PayPal Payments Pro Account Test Site Login Security Center CRE Create your PayPal account secure Your country or region United States v Your language U S English vw Already have a PayPal account Upgrade now Personal Premier Business For individuals who shop online For individuals who buy and sell For merchants who use a online company or group name Learn about low PayPal fees Lookina for a Student account About Accounts Fees Privacy Security Center Contact Us Legal Agreements Developers Jobs Mobile Plus Card Referrals Site Feedback H Information about FDIC pass through insurance Fees e Privacy Security Center e Contact Us User Agreement PayPal an eBay Company Copyright 1999 2008PayPal All rights reserved Information about FDIC pass through insurance Creating a PayPal Payments Pro Account You can use a wizard to create a PayPal Payments Pro business account by clicking the PayPal Payments Pro link for Create Account This action automatically places you in the Sandbox Test Site where you create the test account just as you would create a PayPal Payments Pro account on the live site using a wizard to take you through the steps Sandbox User Guide April 2012 21 22 Setting Up Test Accounts Creating a PayPal Payments Pro Account PayPal Website Payments Pro Getting started a Secure Getthe benefits of a secure internet merc
48. nitiating the payment of funds You must use a Personal test account to represent the buyer To send funds from one test account to another 1 Log in to https developer paypal com click the Test Accounts tab select a test account and click Enter Sandbox Test Site 2 Navigate to the Send Money tab 3 On the Send Money page enter the email address PayPal account name for the test account in Recipient s Email box 4 Enter the amount to send to the seller s test account in the Amount box 5 Select the currency for the funds in the Currency drop down list Note Auction is not an option in the drop down list 6 Select the reason for sending the funds in the Type drop down list 7 Enter text in the Subject box if you want to This text is the subject of the email sent to the recipient about the transfer of funds 8 Enter text in the Note memo box This text appears in the body of the notification email 9 Click Continue This does not send the money a confirmation step follows 10 On the Check Payment Details page review the transaction details for correctness You can click More Funding Options to change the source of fund used for payment 11 Click Send Money This triggers the actual transfer of funds 12 Your Test Email tab contains all the email messages that are sent to the test account sending the money and the test account receiving the money See Test Email on page 12 Log in as the seller
49. ollowing table identifies valid AVS codes corresponding triggers and a description of each error condition AVS Code Trigger Description of Error A AVS_A The address matches but no zip code is specified results in an error if the Partial Address Match risk control is set AVS_B The international address matches but no zip code is specified results in an error if the Partial Address Match risk control is set AVS_D Exact match no error The international address and postal code matches AVS_F Exact match no error The UK address and postal code matches AVS_P The postal code matches but no address is specified results in an error if the Partial Address Match risk control is set AVS_W The 9 digit zip code matches but no address is specified results in an error if the Partial Address Match risk control is set AVS_X Exact match no error The complete address and 9 digit zip code matches April 2012 Sandbox User Guide Testing Error Conditions Testing Using AVS Codes AVS Code Trigger Description of Error Y AVS_Y Exact match no error The complete address and 5 digit zip code matches Z AVS Z The 5 digit zip code matches but no address is specified results in an error if the Partial Address Match risk control is set N AVS N No address information results in an error if the No Address Match risk control is set C AVS_C No address information for an international ad
50. ow governs your PayPal Developer Central n account and any information you provide on the PayPal Developer Central site A Overview v Do you agree to the User Agreement and Privacy Policy and terms incorporated therein O Yes O No IMPORTANT Do not use the same log in email address or password that you use for logging into the live paypal com site because later you may allow someone to work in the Sandbox on your behalf but not want to allow access to your regular PayPal account After you sign up PayPal sends login instructions to the email address you used to sign up If you have mail filtering enabled in your mail software the email sent by PayPal might be filtered out or stored in a folder where you are not expecting it to be For instance with Microsoft Outlook mail software your filtering might cause the email to be stored in Junk or Spam 4 Respond to the confirmation e mail and log in 10 April 2012 Sandbox User Guide Accessing the PayPal Sandbox Welcome to the PayPal Sandbox Welcome to the PayPal Sandbox When you log in to the Sandbox the Sandbox Test Environment home page appears as follows Sandbox Test Accounts Test Email API Credentials Test Tools The PayPal Sandbox allows you to test the integration of your PayPal payment solution before submitting transactions to the live PayPal environment The Sandbox is a duplicate of the live Additional resources Pay
51. ox User Guide Sandbox User Guide Setting Up Test Accounts Managing Test Accounts Log in email Type Country Status Test mode Reset seller 1198117529 _biz li Business United States Verified Disabled Reset ve com E Hide Details Business Name Gary McCue s Test Store Credit Card Visa 4997638765391457 Exp Date 12 2017 Bank Account Checking Confirmed Routing Number 325272199 Bank Account Number 316253011064226 Balance 0 00 USD Email Confirmed Notes Date Created Dec 19 2007 18 25 40 PST Sandbox Test Accounts With API Signatures Test Account Test Account API Username API Password Signature Date Created seller_1198117529_biz live com Dec 19 2007 18 25 41 PST seller_1198117529_biz_apil live com 1198117541 AWYujlOMQYIShjJSo4 XD Iv4tF7TtG AmKFSL2cHk63Scn5SIXIGiKoCV Wx When you click Reset for the account from the Test Accounts tab you are prompted to enter a new password and a note to associate with the account Test Email API Credentials Can We Help Visit the PayPal Developer Community to get answers to integration questions or to file a support ticket Reset a Sandbox Account Reset this sandbox account Only preconfigured test accounts can be reset The email address country and API credentials will not be changed The password payer ID account ID and all credit card and bank account numbers will be changed Country United States Account Type Seller Use to represent yourself
52. r Entry Form Secure Transaction 2 indicates required field Show op fields Order Details currency US Dolas A Net Order Amount 5 Shipping 0 Apply tax to shipping Tax Rate 0000 Tax Amount 0 00 i Total 5 00 Transaction Type Auth v EJ Billing Information Please enter the following information exactly as it appears on the customer s credit card statement Card Type Visa Card Number 401123825125607 PA q Expiration Date 01 w 2008 Card Security Code LE On the back of your card locate the final 3 digit number A SEE What s this Using Amex 54 April 2012 Sandbox User Guide Testing Error Conditions Testing Using CVV Codes When you attempt to process the transaction the following message appears PayPal Log Out Security Center My Account SendMoney RequestMoney Merchant Services Overview Add Funds History Profile Virtual Terminal Order Entry Form Secure Transaction Y 15004 This transaction cannot be processed Please enter a valid Credit Card Verification Number e Gateway Decline e Processor Response Code 0000 e AVS X Address and Whole Zip Match CW N Does not match e Reference 9582BF5CB9B9BV NOTE Other errors are also reported in addition to CVV code N Testing a CVV Code Using DoDirectPayment Consider an example that sets up testing for CCV code N in DoDirectPayment which indicates
53. roducts features you can test in the Sandbox without PayPal APIs e Website Payments with Buy Now Buttons Use the Sandbox to test accepting PayPal as a payment mechanism on a website e Shopping Cart Purchases Use the Sandbox to test the purchase of multiple items in a single transaction using a single payment e Instant Payment Notification IPN Use the Sandbox to test IPN for updates and payment notifications e Refunds Use the Sandbox to test refunding payments from a test buyer e Subscriptions Use the Sandbox to test subscription buttons IMPORTANT To execute test transactions on Sandbox you need to complete a purchase as a test buyer with your buyer test account Typically you go through your website purchase flow as a buyer You must ensure that you execute your test on www sandbox paypal com instead of www paypal com Website Payments with Buy Now Button You can use the Sandbox to familiarize yourself with the PayPal Buy Now button with which you can associate PayPal with a specific item you sell on your website To create a test Buy Now button 1 From the Test Accounts tab select a business account and click Enter Sandbox Test Site 2 Go to the Merchant Services tab 3 Select the Buy Now Buttons link under the Key Features heading to get to the Button Factory You can also search the Help for Button Factory 4 Follow the online instructions to create a Buy Now button For more information see the
54. s Live transactions cleared by live PayPal processes Full protection through PayPal s fraud detection To safeguard your and your customers security requests for digital certificates for use with the Live PayPal Web Services API must be verified by PayPal before they are issued You are notified in email when your request has been approved April 2012 Sandbox User Guide Accessing the PayPal Sandbox To access the PayPal Sandbox sign up for an account at https developer paypal com After signing up you access the Sandbox either programmatically or by logging in Depending on the PayPal feature you want to test with an application you need to set up different types of test accounts PayPal Personal or Premier and Business accounts See Planning the Types of Test Accounts You Need on page 13 Signing Up for Sandbox Access To sign up for Sandbox access 1 Go to https developer paypal com The log in screen is shown below PayPal Developer Central died Member Log In f 4 Email Address Password Log me in automatically cote to the test Need an account Sign up now to access PayPal s Sandbox Test Environment Trouble Logging In Use the Sandbox Test Environment to create and manage test accounts and their associated email Can We Help and API credentials You can also access valuable developer resources from Help Visit the PayPal Developer Sign Up Now Community
55. test account and navigate to the My Account gt Overview tab to see the transaction for the recipient s account Billing A Customer PayPal business users can bill another PayPal user for the purchase of goods or services In PayPal terminology the feature to bill a customer is called Request Money In the PayPal Sandbox you can manually initiate a request for funds from a test account One test account is the seller The other test account is the buyer To request funds from a buyer April 2012 Sandbox User Guide Testing PayPal Website Features ES Billing A Customer 1 Log in to https developer paypal com click the Test Accounts tab select a test account for which funds are requested and click Enter Sandbox Test Site 2 Navigate to the Request Money tab 3 On the Request Money page enter the email address PayPal login name for the test account being billed in the Recipient s Email box 4 Enter the billed amount in the Amount box 5 Select the currency for the funds in the Currency drop down list 6 Select the reason for the request for funds billing in the Type drop down list Note Auction is not an option in the drop down list 7 Enter text in the Subject box This text is the subject of the email sent to the recipient regarding the sent funds 8 Enter text in the Note memo box This text appears in the body of the notification email 9 Click Continue 10 On the Request Money Confirm page
56. tions pass payment review by default If you want to simulate payment review you can enable it from the Test Accounts page as shown on the following screen PayPal Help Profile Log Out Sandbox Sandbox Home Test Accounts Test Email Test Accounts API Credentials Your test accounts are listed below You must have a Business account to represent a merchant Test Tools and a Personal account to represent a buyer To simulate an action on the live site PayPal com select a test account and click Enter Sandbox Test Site Can we help Create Account Preconfigured Create Manually Additional resources Website Payments Pro Documentation y z Payment PayPal Developer Log in email Type Status Ada Test mode Reset Community seller_1220477199_ Business Verified Enabled Disabled Reset Customer Support biz ebay com E View Details O buyer_1220476984_p Personal Verified Enabled N A Reset er ebay com D View Details mopate_1220469128_ Business Verified Disabled Disabled Reset biz ebay com E View Details Enter Sandbox Test Site When payment review is enabled all transactions become pending as shown below Sandbox User Guide April 2012 57 58 Testing Payment Review logged in as KCHALUVADI PAYPAL COM PayPal Developer Central Test Site Log Out Security Center Search PayPal My Account Send Money Request Money Merchant Services Auction Tools Products amp Services Transaction Details
57. to get answers to integration questions or to file a support ticket 2 If you already have an account enter your Log In Email and Password and click Log In 3 If you do not already have an account click Sign Up Now and provide the requested information shown below Sandbox User Guide April 2012 Accessing the PayPal Sandbox Signing Up for Sandbox Access Sign Up for Access to the Sandbox Test Environment This account will allow you to use the PayPal Sandbox Test Environment to try out Website Payments Instant Payment Notification PayPal APIs and other features First Name Last Name Email Address Do not use your PayPal account login email Password At least 8 characters long case sensitive Confirm Password Security Question select a question v Security Answer Communications Please keep me informed on PayPal s Web Services the PayPal Sandbox and Developer Central Terms of Use The User Agreement and Privacy Policy are designed to protect and inform you of your rights within the PayPal Developer Central service User Agreement Printer Friendly Version THE FOLLOWING DESCRIBES THE TERMS ON WHICH PAYPAL OFFERS YOU A ACCESS TO OUR PAYPAL DEVELOPER CENTRAL SERVICES This User Agreement Agreement is a contract between you and PayPal Inc and applies to your use of the PayPal Developer v Privacy Policy Printer Friendly Version The Privacy Policy bel
58. to represent a buyer To simulate an action on the live site PayPal com select a test account and click Enter Sandbox Test Site Customer Support Developer Central Create Account Preconfigured Create Manually Website Payments Pro US UK Negative Log in Email Payment Review Test Mode Reset TestsB_1254900954_bizGpaypal com Disabled Disabled Reset Business Verified E Hide Details Country United States Business Name sa v s Test Store Credit Card Visa 4862147293709687 Exp Date 10 2019 Bank Account Checking Confirmed Routing Number 325272063 Bank Account Number 316986173464501 Balance 0 00 USD Email Confirmed Notes Date Created Oct 7 2009 00 36 14 PDT _ Enter Sandbox Test te Delete Verified Account Status By default a preconfigured test account has a confirmed bank account and email addresses To create an unverified account change the bank account to unconfirmed Resetting a Preconfigured Account You can reset a preconfigured test account This is useful when you want to rerun transactions and need to start from the same point as the original test Resetting a test account preserves information required to rerun the test such as the account email address API credentials credit card and bank accounts and starting balance It does not however use the same bank account or credit card numbers Consider the following account information associated with a test account April 2012 Sandb
59. tralia Canada Germany UK BSB Number 242 200 Transit Number 00001 Routing Number Bank Account Number 37020500 Any 8 digit number Account Number any Institution Number 311 Bank Account Number Sort Code 609204 or random number Any 10 digit number 700709 Bank Account Number Sort Code Any 8 digit Any one digit to 12 digit number number To add a bank account 1 Select a test account and click Enter Sandbox Test Site 2 Navigate to My Account gt Profile Sandbox User Guide April 2012 23 24 Setting Up Test Accounts Adding a Funding Source Under the Financial Information header click the Bank Accounts link In the Bank Account window click Add In the Add Bank Account window Enter a fictitious bank name Using the automatically generated bank account number as the name of the bank will make that account number visible to you for use in testing later Except for UK or German test bank accounts leave all other automatically generated information as is Make a note of the test bank account number because it will be handy to have when you do your testing Click Add Bank Account In the resulting success window click the Continue button at the bottom The My Account gt Overview page opens Click the Confirm Bank Account link in the Activate Account box at the left side In the Confirm Bank Account window click Submit Adding Credit Cards A credit card
60. ue you specify depends on the kind of field e for amount related fields specify a value as a number with two digits to the right of the decimal point for example 107 55 triggers PP API error 10755 e for other kinds of fields specify the actual PP API error for example 10755 triggers PP API error 10755 The following table identifies the API the NVP name or SOAP element of the field that triggers the error and a description of how to set the value in the field API Name NVP Field Name SOAP Element Description RefundTransaction AMT Amount Specify the error code to trigger as all digits in a number with two digits to the right of the decimal point for example 107 55 triggers PP API error code 10755 GetTransaction TRANSACTIONID TransactionID Specify the error code to trigger as all Details digits in the field for example an ID of 10755 triggers PP API error code 10755 TransactionSearch INVNUM InvoiceID Specify the error code to trigger as all DoD Set Get digits in the field for example an ID of 10755 triggers PP API error code 10755 irectPayment AMT OrderTotal Specify the error code to trigger as all digits in a number with two digits to the right of the decimal point for example 107 55 triggers PP API error code 10755 ExpressCheckout MAXAMT MaxAmount Specify the error code to trigger as all digits in a number with two digits to the right of the decimal point for example 107 55 trig
Download Pdf Manuals
Related Search