GetUserAgreement API Operation

Gets the user agreement for the customer to approve the new PayPal account.

User agreement management

PayPal requires account holders to agree to its User Agreement when they sign up for an account. You can use the GetUserAgreement API operation to obtain the agreement before or after the account has been created. For example, you might want to enable a potential account holder to view the agreement before you redirect them to PayPal to confirm account creation, or you might want to enable an existing PayPal account holder to view the user agreement without logging in to PayPal. The terms of the user agreement depend on the country associated with the account, which is specified when the account is created. The user agreement is typically available in the most common languages used within a country. You can specify the contents and language of the user agreement by specifying one of the following sets of information in the request of the GetUserAgreement API operation:

• The account key returned in the response to the CreateAccount API operation
• The country and language of the account

The response to the GetUserAgreement API operation contains the text of the user agreement as a text string. If an account key is specified in the request, the user agreement is appropriate for the country and language of the account; otherwise, the user agreement is for the specified country and language.Typically, you use country and language to display an agreement before the account has been created and use the account key after the account has been created. You can format the text to match the presentation characteristics of your site.

GetUserAgreement request

The GetUserAgreement request functions to request the PayPal's user agreement for the user to approve during account creation. The type of user agreement that is presented depends on the country and the language selected. For example, the PayPal account user may be a native Spanish speaker in the United States. In this case, the GetUserAgreement method presents a version of the agreement tailored for the United States in Spanish.

GetUserAgreement fields

The following table lists the required and optional fields for the GetUserAgreement request. The user agreement is tailored to the PayPal user's language and country code settings. You can either pass the country code and language code, or you can simply pass the createAccountKey that was returned in the CreateAccountResponse message.

RequestEnvelope fields

GetUserAgreement response

The GetUserAgreement response includes the string with the text of the user agreement in the language requested for the country in which the account is located.

GetUserAgreement Response Fields

ResponseEnvelope fields

SOAP GetUserAgreement example

This example shows how to set up a request to obtain the user agreement associated with a specific country and language. The response contains the agreement itself.

SOAP request

In this example, the country is US and the language is en_US.

1<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
2<soapenv:Body>
3<ns2:GetUserAgreementRequest xmlns:ns2="https://svcs.paypal.com/services">
4<requestEnvelope>
5<errorLanguage>en_US</errorLanguage>
6</requestEnvelope>
7<countryCode>US</countryCode>
8<languageCode>en_US</languageCode>
9<agreementType>Personal</agreementType>
10</ns2:GetUserAgreementRequest>
11</soapenv:Body>
12</soapenv:Envelope>

SOAP response

The response contains the actual agreement, which you typically format before presenting to the user.

1<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
2<soapenv:Header />
3<soapenv:Body>
4<ns2:GetUserAgreementResponse xmlns:ns2="https://svcs.paypal.com/types/aa">
5<responseEnvelope>
6<timestamp>2009-09-03T15:09:25.101-07:00</timestamp>
7<ack>Success</ack>
8<correlationId>860b4b0d476df</correlationId>
9<build>1033575</build>
10</responseEnvelope>
11<agreement>
12
13This User Agreement ("Agreement") is a contract between you and PayPal and applies to your use of PayPal's Services. You must read, agree with and accept all of the terms and conditions contained in this Agreement. In addition, you must read, agree with and accept any applicable agreements on the Legal Agreements page.
14...
15"Viewable Online Signature Confirmation" means documentation that can be viewed online at the Approved Shipper's website and includes the signature of the person who received the package.
16"User," "you," or "your" means you and any other person or entity using the Service.
17</agreement>
18</ns2:GetUserAgreementResponse>
19</soapenv:Body>
20</soapenv:Envelope>

GetUserAgreement errors