Paytently

Supports in this guide: Payments

Provider website: paytently.com

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

1. Choose account type
2. Get your credentials (from Paytently)
3. Connect in Dashboard
4. Send an API request

Choose account type

Paytently can be connected in different ways (depending on your needs):

• If you process card payments directly, without redirecting the customer to a Paytently-hosted page to enter card details -> choose H2H Merchant account
• If you want Paytently to host the payment page, including Apple Pay and Google Pay -> choose Provider account

Paytently does not currently support payouts through either account type. If you're not sure which one to use, confirm with your Corefy account manager.

Prerequisites: get from Paytently

Contact your Paytently account manager to get your account verified and receive the following credentials. H2H Merchant account and Provider account are separate connections with independent credentials.

For H2H Merchant account:

• Merchant ID -> Corefy field merchant_id
• API Version -> Corefy field api_version -> optional, choose V1 or V2; defaults to V1 if left blank
• Application ID -> Corefy field application_id -> optional; required if you use API v1
• Public key -> Corefy field public_key -> optional, uploaded as a file; required if you use API v1
• Private key -> Corefy field private_key -> optional, uploaded as a file; required if you use API v1
• Client ID -> Corefy field client_id -> optional; required if you use API v2
• Client Secret -> Corefy field client_secret -> optional; required if you use API v2
• Route ID -> Corefy field route_id -> optional; required if you use API v2
• Test Mode -> Corefy field test_mode -> only applies to API v2; API v1 always runs against Paytently's production environment - there is no API v1 sandbox

For Provider account:

• Client ID -> Corefy field client_id
• Client Secret -> Corefy field client_secret
• Route ID -> Corefy field route_id
• Test Mode -> Corefy field test_mode -> enable if you are using sandbox credentials

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "2b369d7e-b3a5-42db-9132-9dfb387a2e55",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 15
    }
  }
}

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "3c47a681-9d2a-4f6b-9a1e-5b6c7d8e9f01",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 15,
      "customer": {
        "reference_id": "cus_123",
        "first_name": "John",
        "last_name": "Smith",
        "email": "john.smith@example.com",
        "phone": "+15551234567",
        "date_of_birth": "1990-05-20",
        "address": {
          "full_address": "742 Evergreen Terrace",
          "country": "DE",
          "city": "Berlin",
          "post_code": "10115"
        }
      }
    }
  }
}

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "5e7f8a9b-1c2d-4e3f-9a0b-1c2d3e4f5a6b",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 15
    }
  }
}

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "6f8a9b0c-2d3e-4f5a-8b1c-2d3e4f5a6b7c",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 15,
      "customer": {
        "reference_id": "cus_123",
        "first_name": "John",
        "last_name": "Smith",
        "email": "john.smith@example.com",
        "phone": "+15551234567",
        "date_of_birth": "1990-05-20",
        "address": {
          "full_address": "742 Evergreen Terrace",
          "country": "DE",
          "city": "Berlin",
          "post_code": "10115"
        },
        "metadata": {
          "ip": "203.0.113.5"
        }
      }
    }
  }
}

Additional info

1. Both account types share the same modern API - API v2 on the H2H Merchant account and the Provider account both call Paytently's api.paytently.io REST API (sandbox: sandbox.api.paytently.io); only API v1 on the H2H Merchant account uses a separate, production-only endpoint with no sandbox.
2. Active reconciliation is available - both account types support an active status request to Paytently, in addition to the asynchronous callback.
3. No recurring - this connector does not support saving/charging a token through Corefy.
4. Callback routing is automatic - Corefy generates the callback/return URLs per transaction, nothing to configure in Paytently's own back-office.
5. Apple Pay and Google Pay are Provider-account only - the H2H Merchant account only processes card payments; Apple Pay and Google Pay are available through the Provider account's hosted payment page.

FAQ / Troubleshooting

• Invalid credentials / auth error -> verify the credentials for the selected account type, API version, and environment - H2H Merchant account (API v1 or v2) and Provider account use entirely different credential sets
• Currency or service is not supported -> confirm allowed currencies/features in your Paytently account and in Corefy
• Refund fails on a second attempt -> only one refund per payment is allowed
• Not sure which account type to use? -> H2H Merchant account processes card payments directly; Provider account redirects to a Paytently-hosted page and additionally supports Apple Pay and Google Pay
• Not sure which API version to use on the H2H Merchant account? -> API v2 is the current REST API and supports a sandbox; API v1 is the legacy signed API and is production-only