Developer Documents

Advanced Payments (AP) Merchant Account

To begin integrating your app with the Advanced Payments platform (AP), you will need to first sign up for an Explorer test account which gives you access to our Test Environment and enables you to configure, test and fine-tune your integration in a safe, non-production, environment.

Your Explorer account gives you the following capabilities:

• Access our Merchant Integration Test Environment (MITE) and submit test card transactions to our RESTful API
• View your transactions in our Merchant Portal to analyse your payments and perform manual refunds
• Experiment with a number of integration methods including fully hosted and PayPal payments.

In order to handle your requests securely and reliably, you will need to submit credentials specific to your organisation with each request. You will also be issued with at least one installation identifier. You will need to incorporate these credentials into your mobile application using the SDK.

Note – Our Implementations team will provide your Live credentials once your integration is complete and your account is set up and ready to use.

After account creation, two sets of credentials will be assigned: username, password, installationId.
These credentials are essential and will be used to access the Advanced Payment API directly and used in the Mobile SDK to generate the authentication token.

Each set will be used to access either the MITE (TEST) or LIVE Environment.

Google Pay

If you wish to enable the Google Pay Payment Method please refer to our integration team for enabling it.

Setup

You will need to provide your Payment Profile ID located in the Google Pay Portal, usually in the top right corner and starts with BCR

Apple Pay

If you wish to enable the Apple Pay Payment Method please refer to our integration team for enabling it.

Setup

Create Apple Pay Payment Processing Certificate

This action will have to be done for each environment (MITE (test) and LIVE)

Create a merchant identifier

The following documentation is extracted from Apple Pay Configuration Docs

A merchant identifier uniquely identifies you to Apple Pay as a merchant who is able to accept payments. A merchant identifier never expires, and you can use the same one for multiple apps.

1. In Certificates, Identifiers & Profiles, click Identifiers in the sidebar, then click the add button (+) on the top left.
2. Select Merchant IDs, then click Continue.
3. Enter the merchant description and identifier name, then click Continue.
4. Review the settings, then click Register.

Alternatively, you can create a merchant identifier in Xcode.

Create a payment processing certificate

A payment processing certificate is associated with your merchant identifier and used to encrypt payment information. The payment processing certificate expires every 25 months. If the certificate is revoked, you can recreate it.

1. In Certificates, Identifiers & Profiles, click Identifiers in the sidebar.
2. Under Identifiers, select Merchant IDs using the filter on the top right.
3. On the right, select your merchant identifier.

Note: If a banner appears at the top of the page saying that you need to accept an agreement, click the Review Agreement button and follow the instructions before continuing.

4. Under Apple Pay Payment Processing Certificate, click Create Certificate.
5. Request a certificate signing request using the following endpoint:

Request Processing Certificate Signing Request

Base URL:

API Example:

Request:

POST /acceptor/rest/applepay/{{installationId}}/processingCsr
Content-Length: 0
Accept: application/x-pem-file

Response:

HTTP/1.1 200
Content-Type: application/x-pem-file
-----BEGIN CERTIFICATE REQUEST-----
MIHYMH8CAQAwHTEbMBkGA1UEAxMSYXAuZGV2LmV4YW1wbGUuY29tMFkwEwYHKoZI
zj0CAQYIKoZIzj0DAQcDQgAEXGRIw23fV0LllTafRR+E6cf7SX0p0O1ZelUvbNuc
3WJ16uqfvqxTZarjROElLI8/naT+sf4+C+nnxmQLRhb0aqAAMAoGCCqGSM49BAMC
A0kAMEYCIQC8mkmYbFxj6uvqVVfDHY3JBD9jGTIs5/fP0apnU5V4fwIhAMpyYSju
jMTqFkyVk8eCyLJ66vxGcMVWrl2cs97bM2jB
-----END CERTIFICATE REQUEST-----

API Endpoint:

Parameters:

Response:

The CSR in PEM format

6. Click Choose File.

In the dialog that appears, Select the certificate generated by our API.

7. Click Continue.
8. Click Download.
9. Using the downloaded pkix certificate from the Apple Developer Console, upload it to our API using the following endpoint:

Upload Apple Pay Processing Certificate

Base URL:

API Example:

Request:

POST /acceptor/rest/applepay/{{installationId}}/processingCert
Content-Type: application/pkix-cert
[binary file content]

Response:

HTTP/1.1 200

API Endpoint:

Parameters:

Request:

The raw certificate file

Sandbox Testing

Please refer to the Apple Pay Sandboxing testing