Skip to content

Logo

Cecabank

Supports in this guide: Payments

Provider website: cecabank.es

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

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

Choose account type

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

  • If you do H2H card payments -> choose H2H Merchant account

If you are not sure which one to use, confirm with your Corefy account manager.

Prerequisites: get from Cecabank

Get the following values for your Cecabank project/account:

  • Merchant ID -> Corefy field merchant_id -> example: MID00012345 -> where to find: Cecabank backoffice / issued by Cecabank manager
  • Acquirer BIN -> Corefy field acquirer_bin -> example: 00012345 -> where to find: Cecabank backoffice / issued by Cecabank manager
  • Terminal ID -> Corefy field terminal_id -> example: TRM00123 -> where to find: Cecabank backoffice / issued by Cecabank manager
  • Encryption Key -> Corefy field encryption_key -> format: a secret key string used to sign/encrypt requests to Cecabank -> where to find: Cecabank backoffice / issued by Cecabank manager
Payments processing (connect H2H Merchant account, create payment-invoice)

Connect H2H Merchant account in Corefy Dashboard

Step 1 - Open connection form

Open Cecabank in the provider directory and press Connect at Cecabank Provider Overview page in the New connection section. Choose H2H Merchant account.

Step 2 - Fill in fields and select settings

  • Merchant ID
  • Acquirer BIN
  • Terminal ID
  • Encryption Key
  • Test Mode -> (enable if you are using sandbox credentials)

Choose Currency and Features. You can set these parameters according to available currencies and features for your Cecabank account, but it is necessary to check details of the connection with your Corefy account manager.

Success

You have connected Cecabank H2H Merchant account!

First request to Corefy API

What it does: creates a payment-invoice.

Payment - Actual

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "20376e73-140f-4f76-a223-d2f7c69708bb",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 10
    }
  }
}
Cecabank's connector doesn't read any customer fields from the request, so there's nothing optional worth adding on top of the required reference_id/service/currency/amount envelope. Card details (PAN, expiry, CVV) are collected separately through Corefy's own card data form, not part of this JSON body.

Refunds

Cecabank supports partial refunds, but only one refund per payment (no multiple partial refunds against the same payment).

Additional info

  1. Cecabank supports Apple Pay and Google Pay, with token decryption handled by Corefy.

    For more information, visit:

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify credentials for the selected environment and account type
  • Currency or service is not supported -> confirm allowed currencies/features in your Cecabank account and in Corefy
  • Missing required fields -> provide missing request fields; Cecabank's connector does not use Constants-style fallback fields
  • Not sure which account type to use? -> ask your Corefy account manager

Question

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