Skip to main content
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:
VISA, Mastercard, Maestro, Dankort via Valitor payment acquirer.
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.
parametervaluesnote
environmenttest or productionConfigure 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"
}