Skip to content

Logo

DIMOCO

Access the digital economy

Supports in this guide: Payments

Provider website: dimoco-payments.com

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

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

Prerequisites: get from DIMOCO

Send a connection request at dimoco-payments.com/contact or contact your DIMOCO account manager directly to get your account verified and receive the following credentials.

  • Username -> Corefy field username.
  • Password -> Corefy field password.
  • API key -> Corefy field api_key.
  • Secret key -> Corefy field secret_key.

USD, EUR.

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

Connect H2H Merchant account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • Username
  • Password
  • API key
  • Secret key

Success

You have connected DIMOCO 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. DIMOCO may return a 3D Secure challenge redirect depending on the card.

Payment - MIN

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "d6e82a78-63ba-4bb7-83dd-b110a16c5a79",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 10
    }
  }
}

Payment - MAX

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "2db48b44-bd21-409a-9d3b-6f404e90181f",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 10,
      "description": "Order #12345",
      "customer": {
        "reference_id": "1da3de1c-9924-4b96-813a-d3713294fa68",
        "name": "John Wick",
        "email": "johnwick@example.com",
        "address": {
          "country": "CA"
        }
      }
    }
  }
}

Important

  • customer.name first/last parts are derived from the card's own embossed cardholder name, falling back to customer.name when the card doesn't provide one.
  • No Constants are configured for this connector - if a customer field is missing, it's simply not sent.

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

Refunds

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

Additional info

  1. Active reconciliation is available - both an active status request and the asynchronous callback can finalize the payment.
  2. No recurring - this connector does not support saving/charging a token through Corefy.

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify Username, Password, API key and Secret key
  • Refund fails with multiple attempts -> only one refund per payment is allowed
  • Currency or service is not supported -> confirm allowed currencies/features in your DIMOCO account and in Corefy - only USD and EUR are available
  • Not sure which account type to use? -> DIMOCO has a single H2H Merchant account connection; ask your Corefy account manager if you're unsure

Question

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