Skip to content

Logo

Wpay

Supports in this guide: Payments, Payouts

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

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

Prerequisites: get from Wpay

Contact your Wpay account manager to get your account verified and receive the following credential.

  • API key -> Corefy field api_key.

Bank transfer only (TRY).

Payments and Payouts processing (connect Provider account, create payment-invoice / payout-invoice)

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • API key

Success

You have connected Wpay Provider account!

First request to Corefy API (MIN)

What it does: creates a payment-invoice; Wpay returns a redirect link to its own hosted bank-deposit page, where the customer completes the transfer.

Payment - MIN

POST /api/payment-invoices 

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

Payment - MAX

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "7a8b9c0d-1e2f-4a3b-8c24-7d8e9f0a1b2c",
      "service": "bank_transfer_try",
      "currency": "TRY",
      "amount": 100,
      "customer": {
        "reference_id": "cus_123",
        "name": "Ivanov Ivan"
      }
    }
  }
}

Important

customer.name is the only customer field used - it's sent to Wpay as both the account holder's username and full name. No other customer fields are forwarded.

Payout - MIN

POST /api/payout-invoices 

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "8b9c0d1e-2f3a-4b4c-8d35-8e9f0a1b2c3d",
      "service": "bank_transfer_try",
      "currency": "TRY",
      "amount": 100,
      "fields": {
        "account_number": "99999",
        "beneficiary_full_name": "Ivanov Ivan"
      }
    }
  }
}

Important

fields.account_number and fields.beneficiary_full_name are required for payouts.

Payout - MAX

There is no MAX variant - the request above already includes every field Wpay's API accepts for a payout. customer is not used on the Payouts flow.

Options

No Options are configured for this connector.

Constants

No Constants are configured for this connector.

Refunds

Wpay does not support refunds.

Additional info

  1. No active status request - both Payments and Payouts finalize via an asynchronous callback from Wpay (MD5-signed with your API key), not an active status check.
  2. No recurring - this connector does not support saving/charging a token through Corefy.

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify the API key
  • Currency or service is not supported -> only TRY / bank_transfer_try is available for this connector
  • Transaction stuck in a pending state -> Wpay finalizes transactions via callback only; allow some time before investigating further

Question

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