Skip to content

Logo

Macropay

Tech and advisory for financial institutions

Supports in this guide: Payments

Provider website: macropay.net

What you need to do for start processing transactions (brief summary)

  1. Get your credentials (from Macropay)
  2. Connect in Dashboard
  3. Send an API request

Prerequisites: get from Macropay

Contact your Macropay account manager to get your account verified and receive the following credentials.

  • API ID -> Corefy field api_id.
  • API guid -> Corefy field api_guid.

EUR, via SOFORT bank transfer.

Important

Macropay only exposes the SOFORT payment route to Corefy when your Macropay account has "direct pay" enabled on their side. If no service appears available after connecting, ask your Macropay account manager to enable it - Corefy checks this live on every routes refresh and cannot override it.

Payments processing (connect Provider account, create payment-invoice)

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

Open Macropay in the provider directory and press Connect at Macropay Provider Overview page in the New connection section.

Step 2 - Fill in fields and select settings

  • API ID
  • API guid
  • Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected Macropay Provider account!

First request to Corefy API (MIN)

What it does: creates a payment-invoice and redirects the customer to Macropay's hosted SOFORT checkout.

Payment - MIN

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "d3ffe5a6-b3c8-4996-af73-78fa8533c204",
      "service": "sofort_eur_hpp",
      "currency": "EUR",
      "amount": 10
    }
  }
}

Payment - MAX

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "a3f1c9d0-6b2e-4c7a-9d4e-8f1b2c3d4e5f",
      "service": "sofort_eur_hpp",
      "currency": "EUR",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123",
        "name": "John Doe",
        "email": "john.doe@example.com",
        "phone": "+380680786663",
        "address": {
          "full_address": "Main street 1",
          "country": "DE",
          "city": "Berlin",
          "post_code": "10115"
        },
        "metadata": {
          "ip": "127.0.0.1",
          "merchant_url": "https://merchant-site.example"
        }
      }
    }
  }
}

Important

  • customer.metadata.merchant_url is sent as the storefront URL; if missing, Corefy falls back to your own merchant profile website.
  • If a customer field is missing and no matching Constant is set, it is simply omitted from the request - there is no hardcoded placeholder fallback for this connector.

Extended request (MAX)

Why add extra fields (typical reasons): - Provide additional customer details for compliance/reconciliation - Positively influence conversion rate - Include optional fields required by your specific flow

Options

  • finalize_on_succeeded_status -> optional, boolean - when enabled, a transaction is finalized as soon as Macropay reports it as succeeded; when disabled, it stays pending until the customer's own status check completes.

Constants (fallback fields)

Constants are static values that Corefy can send to the provider instead of dynamic data from your API request, when those fields are missing in the request.

Priority (predictable rule): 1. If a value is present in the request -> Corefy uses the request value 2. Else if the constant is set -> Corefy uses the constant 3. Else -> the field is omitted from the request

Currently available constants (constant -> Corefy API field)

  • country -> customer.address.country
  • first_name -> customer.name (first part)
  • last_name -> customer.name (last part)
  • email -> customer.email
  • phone -> customer.phone
  • full_address -> customer.address.full_address
  • post_code -> customer.address.post_code
  • city -> customer.address.city

Refunds

Macropay does not support refunds.

Additional info

  1. Active reconciliation and callback are both available - Macropay can notify Corefy asynchronously, and Corefy can also actively request the current status.
  2. No recurring - this connector does not support saving/charging a token through Corefy.
  3. No Payouts - this connector is Payments-only.

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify the API ID and API guid for the selected environment (test_mode)
  • No service available to select after connecting -> Macropay has not enabled "direct pay" for your account yet; contact your Macropay account manager
  • Currency or service is not supported -> only EUR via SOFORT (sofort_eur_hpp) is available
  • Refund fails -> Macropay does not support refunds through Corefy

Question

Still looking for help connecting your Macropay account? Please contact our support team!