D24

Website: d24.com

Set up Merchant account

Step 1: Create Merchant account

To create an account send connection request at the d24.com/get-started or contact manager directly. Submit the required documents to verify your account and gain access.

Step 2: Get required credentials

Credentials that have to be issued:

• d24__api_key → Api key
• d24__api_signature → Api signature
• d24__read_only_api_key → Read only api key
• d24__live_url → Live URL
• d24__test_mode → Test Mode

Connect Merchant Account

Step 1. Connect Merchant account at the Corefy Dashboard

Press Connect at D24 Provider Overview page in 'New connection' section and choose Merchant account option to open Connection form.

Enter credentials:

• Api key
• Api signature
• Read only api key
• Live URL
• Test Mode → true/false

Set up Provider account

Step 1: Create Provider account

To create an account send connection request at the d24.com/get-started or contact manager directly. Submit the required documents to verify your account and gain access.

Step 2: Get required credentials

Credentials that have to be issued:

• d24__api_key → Api key
• d24__api_passphrase → API passphrase
• d24__api_signature_key → Api signature key
• d24__live_url → Live URL
• d24__test_mode → Test Mode

Connect Provider Account

Step 1. Connect Provider account at the Corefy Dashboard

Press Connect at D24 Provider Overview page in 'New connection' section and choose Provider account option to open Connection form.

Enter credentials:

• Api key
• API passphrase
• Api signature key
• Live URL
• Test Mode → true/false

You have connected D24 Provider account!

Set up H2H merchant account

Step 1: Create H2H merchant account

To create an account send connection request at the d24.com/get-started or contact manager directly. Submit the required documents to verify your account and gain access.

Step 2: Get required credentials

Credentials that have to be issued:

• d24__api_key → API key
• d24__api_signature → API signature
• d24__api_url → API URL (optional)
• d24__test_mode → Test Mode

Connect H2H Merchant Account

Step 1. Connect H2H account at the Corefy Dashboard

Press Connect at D24 Provider Overview page in 'New connection' section and choose H2H Merchant account option to open Connection form.

Enter credentials:

• API key
• API signature
• API URL → optional base-URL override; when empty, the host is chosen by Test Mode
• Test Mode → true/false

You have connected D24 H2H merchant account!

Provider options

Per-transaction options configured on the route:

• Save instant token → when enabled, and the payment request asks to tokenize, the card is tokenized on the provider side so it can be reused for recurring (instant) payments.
• Send default document type → controls how the payer's document_type is sent (see below).

Payer document type

D24 expects a document_type in the payer data (customer's document type, string, max 10 — e.g. CPF). For the card (H2H) integration this value is resolved per transaction via the Send default document type provider option:

• Send default document type = enabled — the connector sends the default document type taken from the Document type connection constant configured on the Dashboard.
• Send default document type = disabled (default) — the connector sends the value from the customer metadata field document_type (customer.metadata['document_type']).

It is not derived from the customer's country.

3DS authentication

3DS is handled automatically by the provider based on the issuer requirements:

• Frictionless — the payment is completed without any extra step.
• Challenge — the provider returns an authentication URL and the customer is redirected to complete the 3DS challenge. After the challenge the provider notifies the platform and the final payment status is retrieved automatically. No extra configuration is required on your end.

API examples:

Minimum data set to create a payment invoices for boleto_bancario_brl_hpp service

PAYMENT

POST /api/commerce/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"boleto_bancario_brl_hpp",
      "commerce_account":"Hello World",
      "currency":"BRL",
      "amount":500,
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"66c52eae-bf7a-4000-9d60-084e145ae4a1",
        "name":"John Doe",
        "email":"johndoe@email.com",
        "address":{
          "country":"BR"
        }
      },
      "test_mode":true,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "reference_id":"ceef67a6-93bc-486e-bc99-3a941a0a4c8a",
      "service_fields":{
        "document_type":"CPF",
        "document_type":"ID"
      }
    }
  }
}

Maximum data set to create a payment invoices for upi_inr_hpp service

PAYMENT

POST /api/commerce/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"upi_inr_hpp",
      "commerce_account":"Hello World",
      "currency":"INR",
      "amount":500,
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"60ab2102-d7f7-439c-b0b3-0a7b466e999b",
        "name":"Ricardo Carlos",
        "email":"testing@ing.com",
        "phone":"912234567890",
        "address":{
          "full_address":"Some street 1",
          "country":"IN",
          "city":"Mumbai"
        }
      },
      "test_mode":true,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "reference_id":"a9d74bd2-dc5d-4021-9fb4-9b7d80dbf938",
      "service_fields":{
        "account":"test@paymt",
        "document_type":"ID",
        "document_id":"1233131313"
      }
    }
  }
}

Minimum data set to create a payout invoices for bank_transfer_thb service

PAYOUT

POST /api/payout-invoices HTTP/1.0
{
  "data":{
    "type":"string",
    "attributes":{
      "test_mode":true,
      "reference_id":"1729002657",
      "description":"string",
      "currency":"THB",
      "amount":224,
      "service":"bank_transfer_thb",
      "service_amount":60,
      "fields":{
        "beneficiary_country_code_iso":"TH",
        "bank_code":"21",
        "beneficiary_name":"Jesse",
        "beneficiary_lastname":"Pinkman",
        "bank_account":"11954",
        "beneficiary_document_id":"123456***0123"
      },
      "callback_url":"https:\/\/example.com\/payouts\/callback",
      "options":{
        "auto_process":true
      }
    }
  }
}

Maximum data set to create a payout invoices for bank_transfer_thb service

PAYOUT

POST /api/payout-invoices HTTP/1.0
{
  "data":{
    "type":"string",
    "attributes":{
      "test_mode":true,
      "reference_id":"1729002889",
      "description":"string",
      "currency":"THB",
      "amount":224,
      "service":"bank_transfer_thb",
      "service_amount":60,
      "fields":{
        "beneficiary_country_code_iso":"TH",
        "bank_code":"21",
        "beneficiary_name":"Jesse",
        "beneficiary_lastname":"Pinkman",
        "bank_account":"11954",
        "beneficiary_address":"Mandaluyong, Metro manila",
        "account_type":"1",
        "beneficiary_document_type":"ID",
        "bank_branch":"11954",
        "beneficiary_document_id":"123456***0123",
        "beneficiary_email":"test@gmail.com",
        "beneficiary_phone":"0982016938",
        "beneficiary_dob":"19870212",
        "beneficiary_city":"Lviv"
      },
      "callback_url":"https:\/\/example.com\/payouts\/callback",
      "options":{
        "auto_process":true
      }
    }
  }
}