Frequently asked questions

Using our APIs

How do I generate a "token" header (JWT) in FCC and Payments products ?

 

  •   Generate a token online through the https://jwt.io/ website by using the following steps:

               1) Select the algorithm RS256 from the Algorithm drop-down menu.
               2) Enter the header and the payload. For more information, see the 'Header and payload format' section below.
               3) Generate an SSH Key Pair. Refere - https://docs.oracle.com/en/cloud/cloud-at-customer/occ-get-started/gener...
               4) Enter the generated private key in the Private Key field of the Verify Signature section. Ensure that you have removed the public certificate from the Public Key or Certificate field, if the certificate exists.

       A token is generated in the Encoded section. Copy this token and use it in the POST API request.

       Header and Payload format:
       The header consists of two parameters:
              i) alg (Mandatory): The signing algorithm being used, such as RS256.
              ii) typ (Optional): The type of the token, which is JWT.

       For example:
       {
             "alg": "RS256",
             "typ": "JWT"

       }

       The Payload conatins complete JSON body of the API request

       For example:
             {"language":"en","enabledCountries":["United Kingdom","Netherlands"],"supportedPaymentMethods":["single"],"buyerDetails":{"firstName":"Test","lastName":"User","emailId":"test@test.com","addressLine1":"Address line 1","addressLine2":"Address line 2","state":"Southampton","country":"United Kingdom","zipCode":"SO53","city":"Cherry Court","isdCode":"+44","mobileNo":"8087495330"},"paymentDetails":{"amount":10.02,"currency":"GBP","accountNumber":"50000012345602","bankBic":"NWBKGBXX","bankCountry":"United Kingdom","reference":"1024556","purpose":"Business Trip"},"successRedirectionUrl":"https://pelican.ai/callback/success","failureRedirectionUrl":"https://pelican.ai/callback/failure","transactionId":"TR00001","state":{}}

I just want to use an API? What are plans?

A plan is collection of API resources or subsets of resources from one or more APIs. A plan can contain a mixture of operation types from different APIs. A plan can have a common rate limit for all the resources or each resource can have a different rate limit. Rate limits specify how many requests an application is allowed to make during a specified time interval.

Use this Developer Portal to browse the different plans that are available to you and select a plan that is most suitable for your requirements. Some plans have restricted access that you must request access to use. When you submit your request, the organization is notified, the API administrator assesses your request and they might contact you for more details. Other plans are available to use straight away.

How do I see my API usage?

The numbers of requests, for different APIs, that your application has made are shown on your application page.

Click 'Apps' in the main menu and then click on your application. In the 'Product Subscriptions' table you will see all plans your application is subscribed to.

For each API contained in that plan you can see the usage compared to the rate limit of the plan.

How can I test an API?

It is possible to test an API from this Developer Portal.

When looking at the details of an API you will see a list of the operations contained in the API. This will show the verb and path to use for the operation.

If you click on the operation you will see more information about it, what parameters it might take, what it returns, what possible return codes it might use and what they mean.

There is also a 'Try' button on REST APIs which enables you to try the operation out direct from the Developer Portal.

If the API requires a client ID or a client secret for identification then you can specify these using your application credentials at the top of the 'Try' section.

Apps

How do I register an application?

When you add an application you are provided with an API Key and Secret for the application. You must supply these credentials when you call an API that requires you to authenticate your application.

To register an application click on Apps in the main menu and then click on the 'Create new app' link. Once you have provided an application name, description, etc you will be shown your application API Key and Secret.

Make a note of your API Secret because it is only displayed once.

How do I reset my application API Secret?

Your API Secret is stored encrypted so we cannot retrieve the unencrypted version to tell you the value if you forget it.

You can reset it, which will update the stored value and return the new value to you.

To do that click 'Apps' in the main menu, click on the application in question and then you can click the 'Reset' link in the 'API Secret' section.

Your new Secret will be displayed at the top of the page.

Search Developer Forum

Connect to our developer forum to ask questions and search content from experienced developers.

Provide Feedback

Tell us what you think.
CAPTCHA
Enter the characters shown in the image.

Get Social