> ## Documentation Index > Fetch the complete documentation index at: https://docs.hurrypayments.com/llms.txt > Use this file to discover all available pages before exploring further. # Connect SumUp This guide explains how to connect your SumUp account to Hurry to accept card payments through SumUp's Checkout API. The wizard has three steps: API keys, checkout domain and settings. > **Note:** SumUp checkouts are always created in **EUR**. If the order is in another currency, the amount is converted to EUR before it's charged. *** ## Before you start You need two things: * A SumUp account with access to API keys (**SumUp Dashboard → Developers → API keys**). * A subdomain pointing to Hurry's IP, from which the checkout will be served. ### Create the DNS record Go to your domain's DNS panel and create an **A** record with the following settings: | Type | Name | Value | | :- | :- | :- | | A | checkout | 72.62.171.205 | > **Note:** DNS propagation can take anywhere from a few minutes to several hours depending on your domain provider. *** ## Step 1. Add the gateway In the side menu, go to **Payment providers** and click **Add payment processor**. ![Payment providers list with the Add payment processor button](https://mintcdn.com/hurrypay/w97W-oXnF9QrulqC/images/sumup-01-payment-providers.jpg?fit=max\&auto=format\&n=w97W-oXnF9QrulqC\&q=85\&s=8e8e4697cc985dc7bae7933a19c14677) In the **Connect a payment gateway** window, select **SumUp**. ![Gateway selector with SumUp in the Guided setup list](https://mintcdn.com/hurrypay/w97W-oXnF9QrulqC/images/sumup-02-select-gateway.jpg?fit=max\&auto=format\&n=w97W-oXnF9QrulqC\&q=85\&s=921f128fa5b0c5cda988ab8f29b15dc6) *** ## Step 2. Enter the API keys Copy the keys from [developer.sumup.com/api-keys](https://developer.sumup.com/api-keys) (you can also open it with the **Open SumUp** button) and paste them into the form: | Field | What to enter | | :- | :- | | **Secret key** | Starts with `sup_sk_`. It's stored only on the server and never reaches the buyer's browser. | | **Public key** | Starts with `sup_pk_`. It must belong to the same SumUp account as the secret key. | | **Checkout API base URL** | Leave it as is (`https://api.sumup.com/v0.1`) unless SumUp has given you a different host. | When each key's format is correct, the **Format looks right** message appears. ![SumUp API keys form with both keys validated](https://mintcdn.com/hurrypay/w97W-oXnF9QrulqC/images/sumup-03-api-keys.jpg?fit=max\&auto=format\&n=w97W-oXnF9QrulqC\&q=85\&s=c2073dbc6d88680aac3100cc1863e853) Click **Validate and connect**. Hurry checks the keys against SumUp and, if they're valid, moves to the next step. *** ## Step 3. Verify the checkout domain In **White-label subdomain**, enter the subdomain you set up (for example `checkout.yourstore.com`) and click **Verify DNS**. If the record points correctly to Hurry's IP, you'll see the confirmation message and the button changes to **Verified**. Click **Next**. ![Verified subdomain pointing to Hurry's IP](https://mintcdn.com/hurrypay/w97W-oXnF9QrulqC/images/sumup-04-domain-verified.jpg?fit=max\&auto=format\&n=w97W-oXnF9QrulqC\&q=85\&s=f4d0cede35fbd4c5002f120fc8a9d4f5) > **Note:** You can't continue until the subdomain points to our IP. If verification fails, check the A record and wait for it to propagate. *** ## Step 4. Review the connection status The settings screen starts with three information blocks: * **Connected account**: your SumUp account name and its *merchant code*, with the status **Connected**. * **SSL status**: the subdomain certificate is generated automatically and takes about 15 minutes. While it shows **Pending**, test the checkout on the platform domain. * **Payment notifications**: the notification URL is already active. Hurry sends it as the `return_url` on every checkout, so **you don't need to register any webhook in SumUp**. ![Connection status: connected account, SSL being provisioned and active notifications](https://mintcdn.com/hurrypay/w97W-oXnF9QrulqC/images/sumup-05-settings-status.jpg?fit=max\&auto=format\&n=w97W-oXnF9QrulqC\&q=85\&s=db56c06d1a5e8572e116e08d42ed89cc) *** ## Step 5. Name, status and traffic * **Name**: internal name to identify the gateway. It's prefilled with your SumUp account name; change it if you'll connect more than one so you don't mix them up. * **Status**: `Active` or `Inactive`. An inactive gateway stays saved but doesn't receive payments until you activate it. * **Traffic**: relative weight used to split payments between your gateways. * **Merchant code**: read from your SumUp profile when the keys are validated. You don't need to change it. If you need to rotate the keys later, use **Change the API keys**. ![Name, status, traffic and SumUp account settings](https://mintcdn.com/hurrypay/w97W-oXnF9QrulqC/images/sumup-06-settings-name-traffic.jpg?fit=max\&auto=format\&n=w97W-oXnF9QrulqC\&q=85\&s=1c62142421bfabade8f39f512ddfaf69) *** ## Step 6. Advanced settings (optional) The default values work in most cases. | Field | What it's for | | :- | :- | | **Payment descriptor** | Description stored with the payment. Include your domain so the buyer recognizes the charge. | | **Checkout URL prefix** | Must point to the SumUp checkout page: `/checkout/detail/sumup?orderId=` | | **Success URL** | Page the buyer lands on when the payment is completed. | | **Notification URL** | Set by the platform. It must be reachable from the internet. | | **Amount multiplier** | `1.00` = no change, `1.10` = +10%. | | **Fixed price** | Optional fixed amount. Leave it empty if you don't need it. | | **Recurring payment** | Creates the checkout so the card can be charged again later (subscriptions), instead of a one-time payment. | | **Fake email** | Sends a masked email to the gateway; the real email is only used in the CRM. | ![Advanced settings: checkout URLs, prices and flags](https://mintcdn.com/hurrypay/w97W-oXnF9QrulqC/images/sumup-07-settings-advanced.jpg?fit=max\&auto=format\&n=w97W-oXnF9QrulqC\&q=85\&s=c9b48912ee4c3edef75068ad70df080f) *** ## Step 7. Save Click **Save credential**. You'll see the **Credential created successfully** message. ![Credential created successfully message](https://mintcdn.com/hurrypay/w97W-oXnF9QrulqC/images/sumup-08-credential-created.jpg?fit=max\&auto=format\&n=w97W-oXnF9QrulqC\&q=85\&s=b2c8848a8d21eec11b1bd62a23f02359) *** ## Done! Your SumUp account now appears in **Payment providers**. From the list you can turn it on or off with the **Status** toggle and see the SSL status. ![The SumUp gateway in the Payment providers list](https://mintcdn.com/hurrypay/w97W-oXnF9QrulqC/images/sumup-09-list-result.jpg?fit=max\&auto=format\&n=w97W-oXnF9QrulqC\&q=85\&s=23cbd58b421e10f835f44d7163db8c21) If you want to add another SumUp account or any other supported gateway in the future, just repeat this process. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.