Skip to content

Apple Pay Alternative

AM Integration option

Payment flow

  1. Customer initiates Apple Pay payment on the merchant's website.
  2. Merchant sends the payment request to PacoPay Service Provider
  3. PacoPay Service Provider returns a payment link to the merchant.
  4. The merchant redirects the customer to the payment link. The link opens the page which displays the transaction amount along with a button to make a payment using Apple Pay.
  5. The customer completes the payment using Apple Pay.
  6. PacoPay Service Provider sends a webhook notification to the merchant. The merchant may also request the payment status from PacoPay Service Provider with the status query. If the transaction was successful, the webhook notification and the response to the status query may additionally contain apple_pay_alt.account_number parameter with the card mask value.
Card mask in the webhook notification 
{
  "transaction": {
  ...
    "apple_pay_alt": {
      "account_number": "41111111XXXX1111"
    },
  ...
}

Info

This integration option only supports EUR currency.

Payment

Request

Send a payment request with the following additional parameters:

object
amount
required
 bigInteger
Transaction amount in minimal currency units, for example, 5000 (50 euros).
ip
 string
The customer's IP address.
return_url
required
 string
URL to return the customer to when the transaction is completed.
object
A section of the payment method.
type
required
 string
apple_pay_alt
object
A section of information about the customer.
first_name
 string
The customer's first name.
last_name
 string
The customer's last name.
email
 string
The customer's email address.
country
 string (2)
The customer's country in the ISO 3166-1 Alpha-2 format. For example, DE.
object
A section of the additional data parameters.
object
A section of information about the customer.
id
required
 string
The customer's identifier in the merchant's system.
Request example 
{
  "request": {
    "amount": 200,
    "currency": "EUR",
    "description": "description",
    "return_url": "https://your_return_url.com",
    "method": {
      "type": "apple_pay_alt"
    },
    "additional_data": {
      "customer": {
        "id": "12435"
      }
    }
  }
}
Response

Redirect your customer to the URL that is formed the following way: URL from form.action + ? + theform.fields.name value + = + the form.fields.value value.

For example: https://example.com/url-for-redirect?data=eyJpZCI6MjE4MTI4ODU2MSwiY29udHJvbCI6IjVlZDkyODBjZDFhNzRkZmVmZDRhOWNhNDQ3YmM3ZDFhIn0=.

Response example 
{
    "transaction": {
        "uid": "7f207381-a4dd-470e-8aca-ae4e5269f034",
        "type": "payment",
        "status": "pending",
        "amount": 100,
        "currency": "EUR",
        "description": "test",
        "created_at": "2024-09-04T14:20:56Z",
        "updated_at": "2024-09-04T14:20:57Z",
        "method_type": "apple_pay_alt",
        "receipt_url": "https://dashboard.paco-pay.com/customer/transactions/7f207381-a4dd-470e-8aca-ae4e5269f034/d969286649a10333ddaf1547b803547444cd66af9465d97d5ff526d5fdde6f8f",
        "payment": {
            "status": "pending",
            "gateway_id": 4417,
            "ref_id": "2181300649",
            "message": "Transaction was initialized."
        },
        "apple_pay_alt": {
            "type": "apple_pay_alt"
        },
        "customer": {
            "email": null,
            "ip": null
        },
        "manually_corrected_at": null,
        "version": 0,
        "message": "Transaction was initialized.",
        "tracking_id": "your_uniq_number21212",
        "test": false,
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "https://example.com/url-for-redirect",
            "method": "GET",
            "fields": [
                {
                    "name": "data",
                    "value": "eyJpZCI6MjE4MTMwMDY0OSwiY29udHJvbCI6ImM0OTk1NzVlZjk2NmU5OTllY2YyNDM5MmJiZWNjOWQ3In0="
                }
            ]
        }
    }
}

SS Integration option

Payment flow

  1. The customer initiates the payment on the merchant's website.
  2. The merchant sends the payment request to PacoPay Service Provider.
  3. PacoPay Service Provider sends a response containing the URL for completing the payment.
  4. The merchant redirects the customer to the provided URL.
  5. The customer completes the payment.
  6. PacoPay Service Provider sends a webhook notification with the payment status to the merchant. The merchant may also request the payment status from PacoPay Service Provider with the status query. If the transaction was successful, the webhook notification and the response to the status query may additionally contain apple_pay_alt.account_number parameter with the card mask value.

Info

This integration option supports only EUR currency.

Payment

Request

Send a payment request with the following additional parameters:
object
return_url
required
 string
A URL to return the customer to when a transaction is completed.
object
A section of the payment method.
type
required
 string
apple_pay_alt.
Request example 
{
  "request": {
    "amount": 444,
    "currency": "EUR",
    "description": "test description",
    "test": false,
    "tracking_id": "your_uniq_number21212",
    "ip": "127.0.0.1",    
    "return_url": "https://your-success.url",
    "method": {
      "type": "apple_pay_alt"
    }
  }
}
Response

Redirect your customer to the URL received as the value of the form.action parameter.

Response example 
{
  "transaction": {
    "uid": "cd7f3e9e-3484-407b-a880-b70d9906a0e3",
    "type": "payment",
    "status": "pending",
    "amount": 444,
    "currency": "EUR",
    "description": "test description",
    "created_at": "2025-07-01T07:21:34Z",
    "updated_at": "2025-07-01T07:21:34Z",
    "method_type": "apple_pay_alt",
    "receipt_url": "https://dashboard.paco-pay.com/customer/transactions/cd7f3e9e-3484-407b-a880-b70d9906a0e3/2c5248b0087d16eb66dfca89c2f8f22f3d762660576096dcab8d956133ac9bf4?language=en",
    "payment": {
      "status": "pending",
      "gateway_id": 5527,
      "ref_id": "951599511",
      "message": "Invoice is created successfully, waiting for a payment",
      "bank_code": 31,
      "rrn": 8888,
      "auth_code": 9999
    },
    "apple_pay_alt": {
      "type": "apple_pay_alt"
    },
    "customer": {
      "email": null,
      "ip": "127.0.0.1"
    },
    "manually_corrected_at": null,
    "version": 1,
    "message": "Invoice is created successfully, waiting for a payment",
    "tracking_id": "your_uniq_number21212",
    "test": false,
    "language": "en",
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },    
    "gateway": {
      "iframe": false
    },
    "form": {
      "action": "payment-link",
      "fields": [],
      "method": "GET"
    }
  }
}

Refund

Request

Send a standard refund request. The amount value must equal the amount of the corresponding payment transaction.