User Guide

Invoicing Service API Guide May 2012 19

Invoicing Service API Examples

HTTP Headers

SOAP Messages

To use Adaptive Payments with SOAP, include the HTTP headers for authentication as

described in the section Authentication and the application ID as described in the next section.

In addition, include the X-PAYPAL-MESSAGE-PROTOCOL header with a SOAP11 value.

The following is a header example for an Adaptive Payments API call for a SOAP message:

headers.put("X-PAYPAL-SECURITY-USERID", "tok261_biz_api.abc.com");

headers.put("X-PAYPAL-SECURITY-PASSWORD","1244612379");

headers.put("X-PAYPAL-SECURITY-SIGNATURE","lkfg9groingghb4uw5"

headers.put("X-PAYPAL-DEVICE-IPADDRESS", "168.212.226.204");

headers.put("X-PAYPAL-MESSAGE-PROTOCOL", "SOAP11");

headers.put("X-PAYPAL-APPLICATION-ID","APP-80W284485P519543T");

Below are the service name, port type, binding and location for SOAP as defined in the

Adaptive Payments WSDL.

<wsdl:service name="AdaptivePayments">

<wsdl:port name="AdaptivePaymentsSOAP11_http"

<binding="services:AdaptivePaymentsSOAP11Binding">

<soap:address location="https://svcs.paypal.com/AdaptivePayments" />

Specifying Application and Device Information

You also must identify the application. You can optionally identify other information

associated with the client and the API version:

HTTP Headers for Application and Device identification

Header Description

X-PAYPAL-APPLICATION-ID (Required) Your application’s identification, which is issued

by PayPal.

NOTE: Check X.com for which application ID must be

defined for working in the sandbox.

X-PAYPAL-DEVICE-ID (Optional) Client’s device ID, such as a mobile device’s

IMEI number or a web browser cookie.

X-PAYPAL-DEVICE-IPADDRESS (Required) Client’s IP address.

X-PAYPAL-SERVICE-VERSION (Optional) The version of an API operation to use. By

default, PayPal executes a request with the current version

of an API operation.

NOTE: PayPal recommends not specifying a version unless

it is absolutely required.