Skip to content

Logo

Till Payments

No matter what you do or where you're headed, Till has a way for you to get paid quickly and securely.

Supports in this guide: Payments

Provider website: tillpayments.com

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

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

Prerequisites: get from Till Payments

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

  • Username -> Corefy field username.
  • Password -> Corefy field password.
  • API key -> Corefy field api_key.
  • Shared secret -> Corefy field secret_key.
  • Apple Merchant ID (optional, only for Apple Pay) -> Corefy field apple_merchant_id.
  • Apple certificate (optional, only for Apple Pay) -> Corefy field apple_cert -> uploaded as a file.
  • Apple certificate key (optional, only for Apple Pay) -> Corefy field apple_cert_key -> uploaded as a file.
  • Apple certificate password (optional, only for Apple Pay) -> Corefy field apple_cert_password.
  • Apple display name (optional, only for Apple Pay) -> Corefy field apple_display_name.

USD, AUD.

Payments processing (connect H2H Merchant account, create payment-invoice)

Connect H2H Merchant account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • Username
  • Password
  • API key
  • Shared secret
  • Apple Merchant ID (optional)
  • Apple certificate / certificate key / certificate password / display name (optional)
  • Currency / Features -> choose values available for your account (USD, AUD)
  • Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected Till Payments H2H Merchant account!

First request to Corefy API (MIN)

What it does: creates a payment-invoice; card data itself is collected and submitted separately by Corefy's checkout/SDK layer, not as part of this request. Card and Apple Pay are both supported on this same connection. Till Payments may return a 3D Secure challenge redirect depending on the card.

Payment - MIN

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "f8f6f0f5-38d6-409a-82eb-161252fd6756",
      "service": "payment_card_usd_hpp",
      "currency": "USD",
      "amount": 10
    }
  }
}

Payment - MAX

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "a1b2c3d4-5e6f-4789-8a02-5b6c7d8e9f0a",
      "service": "payment_card_usd_hpp",
      "currency": "USD",
      "amount": 10,
      "description": "Order #12345",
      "customer": {
        "reference_id": "cus_123",
        "email": "test@example.com",
        "address": {
          "country": "US"
        }
      }
    }
  }
}

Important

  • The cardholder's first/last name sent to Till Payments is always taken from the card's own embossed name - customer.name is not used for this.
  • customer.email and customer.address.country are sent only when provided; there's no fallback for either (no Constants exist for this connector).
  • description falls back to an auto-generated value based on your payment reference if not provided.

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

  • ignore_callback -> optional, boolean - for cascading to work correctly, ignores Till Payments' asynchronous callback and relies only on an active status request to finalize the payment.

Refunds

Till Payments supports partial and multiple refunds.

Additional info

  1. Active reconciliation is available - both the asynchronous callback and an active status request can finalize the payment, unless ignore_callback is enabled.
  2. Recurring is supported - this connector supports saving and charging a card token through Corefy (standard tokenize/token-charge flow).

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify the username, password, API key and shared secret for the selected environment (test_mode)
  • Apple Pay not working -> make sure the Apple-specific fields (Merchant ID, certificate, certificate key, certificate password) are all filled in
  • Currency or service is not supported -> confirm allowed currencies/features in your Till Payments account and in Corefy - only USD and AUD are available

Question

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