Altapay is a Danish payment provider supported various means of payment methods including VISA, Mastercard and Swiss.
Introduction
Our integration with Altapay support the following payment methods:
Credit card
Klarna
Swiss
Apple & Google Pay
Paypal
Vipps MobilePay
VISA, Mastercard, Maestro, Dankort via Valitor payment acquirer.
Supported
Supported
Supported
Supported
Supported
AltaPay require that the payment method currency aligns with the invoice currency. A payment method of EUR cannot be used to pay an invice of USD.
Getting started
Sign up for an Altapay account, using the following link.
Enabling Altapay
Before enabling Altapay, you will need to collect your username, password, terminal name and gateway name.
To enable Altapay as a payment provider, use the following snippet:
curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {your_token_here}" \
-H "X-environment: {your_environment_id_here}" \
-H "X-version: 2022-03" \
-d '{ "name": "altapay" }' \
https://api.plude.io/paymentproviders/
You will receive a response as follows:
{
"url" : "https://go.plude.io/t/sQgzPzNDnDeWLiGvVWZQKX",
"expires" : "2022-11-07T22:30:05+00:00"
}
Follow the url parameter and complete the authorization page with your Altapay credentials. You can retrieve the newly configured payment provider by issuing a request using this snippet:
curl -H "X-version: 2022-03" \
-H "Authorization: Bearer your_token_here"
-H "X-environment: {your_environment_id_here}" \
-H "X-version: 2022-03" \
https://api.plude.io/paymentproviders/
You will receive a response as follows:
{
"results" : [
{
"id" : "d64acb1b-4d34-42ee-b888-f59ec0ef9fd0",
"name" : "altapay",
"status" : "active"
..
}
]
}
Configuring Altapay
You can configure Altapay with the following parameters.
| parameter | values | note |
|---|
| environment | test or production | Configure the Altapay environment to use test or production. Default to production. |
To configure Altapay, use the following snippet:
curl -X PUT \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {your_token_here}" \
-H "X-environment: {your_environment_id_here}" \
-H "X-version: 2022-03" \
-d '{ "environment": "test" }' \
https://api.plude.io/paymentproviders/{d64acb1b-4d34-42ee-b888-f59ec0ef9fd0}
Payment methods
Adding a Credit card
Altapay use terminals to distinguish between different payment methods. You must first configure a credit card terminal in Altapay to proceed.
To add a credit card payment method to a Customer, use the following snippet:
curl -X PUT \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {your_token_here}" \
-H "X-environment: {your_environment_id_here}" \
-H "X-version: 2022-03" \
-d '{ "provider": "altapay", "terminal" : "(name of your terminal)", "redirect" : "(your redirect url here)" }' \
https://api.plude.io/customers/{552dabcf-31e5-4998-9d24-0689448ae7cf}/paymentmethods/
Your request will return the following response:
{
"url" : "https://pludesample.altapaysecure.com/merchant/API/...",
"session" : "fc1aa9d4-df96-4088-b1e4-3bb78bc761b0"
}
Redirect the user to the provided URL. The user will be redirected to an Altapay hosted page, and must complete the payment method instructions. Once completed, the user is redirected to the redrect url provided in the initial request.
You will get the following response:
{
"message" : "Payment method created"
}