Clear Junction

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

Open Clear Junction in the provider directory and press Connect at Clear Junction Provider Overview page in the New connection section. Choose Provider account.

Step 2 - Fill in fields and select settings

• API Key -> api_key
• API Password -> api_password
• Wallet ID -> wallet_uuid
• 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 Clear Junction account, but it is necessary to check details of the connection with your Corefy account manager.

First request to Corefy API

What it does: creates a payment-invoice. The customer is shown bank details (taken from the route constants, see below) and a payment reference, and then makes a bank transfer.

Actual

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "service": "bank_transfer_eur_invoice",
      "currency": "EUR",
      "amount": 100
    }
  }
}

Clear Junction doesn't use any customer data for this flow, so the minimal and extended requests are the same.

Options

Options are configured on the Corefy side and affect how Corefy builds provider requests or processes responses.

Currently available options (1)

• time_to_pay - how long (in seconds) the customer has to make the bank transfer before the payment expires.

Constants (bank details for the payment page)

For the bank_transfer_eur_invoice route, constants hold the bank details of the account that receives the customer's transfer. Corefy shows these details to the customer on the payment page, together with the payment reference.

After the successful connection, fill in the constants for the route in the editing menu. All of them are required.

Currently available constants (constant -> shown on the payment page as)

• iban -> IBAN of the receiving account
• bic -> BIC of the receiving bank
• bank -> bank name
• bank_address -> bank address
• account_holder_name -> account holder name
• account_holder_address -> account holder address

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

Open Clear Junction in the provider directory and press Connect at Clear Junction Provider Overview page in the New connection section. Choose Provider account.

Step 2 - Fill in fields (provider -> Corefy)

• API Key -> api_key
• API Password -> api_password
• Wallet ID -> wallet_uuid
• Test Mode -> (enable if you are using sandbox credentials)

First request to Corefy API (MIN)

What it does: creates a payout-invoice.

Payout - MIN

POST /api/payout-invoices

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "service": "bank_transfer_eur",
      "currency": "EUR",
      "amount": 100,
      "customer": {
        "reference_id": "8a033b30-f7e6-451d-9b58-4100eec1884c",
        "name": "John Doe"
      },
      "fields": {
        "account_number": "DE89370400440532013000"
      }
    }
  }
}

fields.account_number is the beneficiary's IBAN. customer.name is required: Corefy splits it into the beneficiary's first and last name, and fails the payout before calling Clear Junction if it's missing.

Payout - MAX

POST /api/payout-invoices

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "service": "bank_transfer_eur",
      "currency": "EUR",
      "amount": 100,
      "customer": {
        "reference_id": "8a033b30-f7e6-451d-9b58-4100eec1884c",
        "name": "John Doe"
      },
      "fields": {
        "account_number": "DE89370400440532013000",
        "payment_purpose": "Withdrawal for order 12345"
      }
    }
  }
}

fields.payment_purpose is sent to Clear Junction as the payout description. If it isn't provided, Corefy uses the payout ID instead.

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

Options are configured on the Corefy side and affect how Corefy builds provider requests or processes responses.

Currently available options (1)

• use_provider_validation - cleans the beneficiary name and payout description so they match the characters Clear Junction accepts.

Constants

Constants are static values that Corefy sends to the provider for the route.

After the successful connection, fill in the constants for the bank_transfer_eur route in the editing menu.

Currently available constants (constant -> Clear Junction request field)

• payer_iban (optional) -> payerRequisite.iban - IBAN of your Clear Junction account that the payout is sent from. It is sent for SEPA Instant payouts only.