OAuth2 for authorization to the API. It is not possible to interact with the API without a valid Partner ID token.
All the authentication tokens are sent using Headers in order to receive the session token.
To obtain a quote for a given “from” and “to currency” and “to amount”, or see the list of supported currencies per country, the calls to these endpoints do not require authentication.
To call any endpoint of our API you need to obtain a token, by calling the token URL:
[POST] https://api-demo.novemberfirst.com/token
With the following data in the body of the POST request:
grant_type=password&username=UserName&password=Password&appid=AppId&partnerid=PartnerId
| Parameter | Comment |
|---|---|
| UserName | The user name of the user that is going to login |
| Password | The password of the user that is going to login |
| AppId | The AppId from the API Settings in the customer portal (Your App Key) |
| PartnerId | The PartnerId you obtain when becoming partner with November First. Ask support if you need the id again. |
Here is an example of the request/response in raw form:
Request:
POST https://api.demo.novemberfirst.com/token HTTP/1.1
Content-Type: application/x-www-form-urlencoded; charset=utf-8
Host: api.demo.novemberfirst.com
Content-Length: 155
Expect: 100-continue
grant_type=password&username=[email protected]&password=1234&appid=CBFD555-9805-4905-tghg347654&partnerid=0454555-7751-4905-tghg345646
Response:
{
"access_token": "Kv0CfU2oU47rfLasmdAS01UBqfbGo6t9G6sgdX... ",
"token_type": "bearer",
"expires_in": 899,
".issued": "Mon, 07 Aug 2017 14:26:06 GMT", ".expires": "Mon, 07 Aug 2017 14:41:06 GMT"
}
After obtaining the access token, you append it on every request using the following header:
Authorization: Bearer [access_token]
Where [access_token] should be replaced with the token you just received.
Here is an example of a create payment request:
POST https://api.demo.novemberfirst.com/payments HTTP/1.1
Authorization: Bearer Kv0CfU2oU47rfLasmdAS01UBqfbGo6t9G6sgdX_...
Host: demo.novemberfirst.com
Content-Type: application/json
Content-Length: 821