Wirecapital

Supports in this guide: Payments, Payouts

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

Choose account type
Get your credentials (from Wirecapital)
Connect in Dashboard
Send an API request

Choose account type

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

If you do direct card payments (with refunds) -> choose H2H Merchant account
If you do card payments via a hosted redirect page -> choose Merchant account
If you do card payouts -> choose Provider account

These are three separate, independent connections with their own credentials. If you're not sure which one to use, confirm with your Corefy account manager.

Prerequisites: get from Wirecapital

Contact your Wirecapital account manager to get your account verified and receive the following credentials.

For H2H Merchant account:

Login -> Corefy field login.
Merchant key -> Corefy field merchant_key.

For Merchant account:

Merchant ID -> Corefy field merchant_id.
Merchant account ID -> Corefy field merchant_account_id.
Username -> Corefy field username.
Password -> Corefy field password.
Key -> Corefy field key.

For Provider account:

Private key -> Corefy field private_key.
Username -> Corefy field username.
Password -> Corefy field password.
Currencies -> Corefy field currency -> select the currencies you'll use for payouts.

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

Connect H2H Merchant account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

Login
Merchant key
Test Mode -> (enable if you are using sandbox credentials)

Success

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

Payment - MIN

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "6f7a8b9c-0d1e-4f2a-8b13-6c7d8e9f0a1b",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 10
    }
  }
}

Payment - MAX

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "7a8b9c0d-1e2f-4a3b-8c24-7d8e9f0a1b2c",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123",
        "email": "john.doe@example.com",
        "name": "John Doe"
      }
    }
  }
}

Important

customer.email is optional - if it's missing, Corefy sends a placeholder email to Wirecapital 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

Refunds

Wirecapital supports partial and multiple refunds against the same payment.

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

Connect Merchant account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

Merchant ID
Merchant account ID
Username
Password
Key
Force 3DS -> (optional): always require a 3D Secure challenge for payments on this connection
Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected Wirecapital Merchant account!

First request to Corefy API (MIN)

What it does: creates a payment-invoice; the customer is redirected to a Wirecapital-hosted page to enter card details.

Payment - MIN

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "8b9c0d1e-2f3a-4b4c-8d35-8e9f0a1b2c3d",
      "service": "payment_card_usd_hpp",
      "currency": "USD",
      "amount": 10
    }
  }
}

Payment - MAX

There is no MAX variant - customer is not used by this flow.

Options

No Options are configured for this connector.

Refunds

This flow does not support refunds.

Payouts processing (connect Provider account, create payout-invoice)

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

Private key
Username
Password
Currencies -> select the currencies you'll use for payouts
Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected Wirecapital Provider account!

First request to Corefy API (MIN)

What it does: creates a payout-invoice and sends funds directly to a card.

Payout - MIN

POST /api/payout-invoices

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "9c0d1e2f-3a4b-4c5d-8e46-9f0a1b2c3d4e",
      "service": "payment_card_usd",
      "currency": "USD",
      "amount": 10,
      "fields": {
        "card_number": "4111111111111111"
      }
    }
  }
}

Important

fields.card_number is required.

Payout - MAX

POST /api/payout-invoices

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "0d1e2f3a-4b5c-4d6e-8f57-0a1b2c3d4e5f",
      "service": "payment_card_usd",
      "currency": "USD",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123",
        "name": "John Doe",
        "phone": "+15551234567"
      },
      "fields": {
        "card_number": "4111111111111111"
      }
    }
  }
}

Important

customer.name is split into first/last name and sent to Wirecapital; customer.phone is forwarded as the recipient's phone number. If either is missing, Corefy substitutes randomly generated placeholder values instead of failing the request.

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

No Options are configured for this connector.

Refunds

Wirecapital does not support refunds for payouts.

Additional info

Three independent connections - H2H Merchant account, Merchant account, and Provider account use entirely separate credentials and serve different flows; connecting one does not affect the others.
Active reconciliation - the H2H Merchant account and the Provider account (Payouts) both support an active status request in addition to any callback. The Merchant account (hosted redirect Payments) is kept up to date via Corefy's own periodic reconciliation instead.
No recurring - none of the three connections support saving/charging a token through Corefy.

FAQ / Troubleshooting

Invalid credentials / auth error -> verify the credentials for the selected account type and environment - all three account types use entirely different credential sets
Refund fails -> refunds are only available on the H2H Merchant account; the Merchant account (hosted redirect) and Provider account (Payouts) do not support them
Currency or service is not supported -> confirm allowed currencies/features in your Wirecapital account and in Corefy - each account type supports a different currency set
Not sure which account type to use? -> H2H Merchant account is for direct card Payments with refunds; Merchant account is for hosted-redirect card Payments; Provider account is for card Payouts

Question

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