User Guide

Invoicing Service API Guide May 2012 17

Invoicing Service API Examples

You can use the Invoicing Service API to create, send, update, cancel, or obtain details of

invoices for yourself or third-party merchants. You can also search invoices, and mark them as

paid, unpaid, or refunded.

HTTP Headers

Each request message includes HTTP headers specifying authentication, the application ID,

the device ID or IP address, and the payload format or protocol (SOAP).

Adaptive Payments supports request bodies with JSON, NVP, and XML data formats for

REST implementations. You can specify different formats for the request and response, such

as sending the request in JSON and requesting an XML response.

For SOAP, you must also include a specific SOAP protocol header (see the SOAP messages

section).

The following is an example of HTTP headers for NVP in Java for a web implementation:

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-REQUEST-DATA-FORMAT", "NV");

headers.put("X-PAYPAL-RESPONSE-DATA-FORMAT", "NV");

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

NOTE: HTTP headers are case sensitive.

Authentication

Use your PayPal account API credentials to authenticate your application. Your API

credentials include an API username and API password. If you are using 3-token

authentication, you must also specify an API signature. If you are using a certificate, the

certificate is used with the username and password; the signature is not used. To specify API

credentials, include the following HTTP headers in your request message (observing case

sensitivity):