Payway

Supports in this guide: Payouts

Provider website: n/a

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

1. Choose account type
2. Get your credentials (from Payway)
3. Connect in Dashboard
4. Send an API request

Prerequisites: get from Payway

Get the following values for your Payway account:

• API key -> Corefy field api_key -> format: password string -> where to find: issued by your Payway account manager
• API first password -> Corefy field api_first_password -> format: password string -> where to find: issued by your Payway account manager
• API second password -> Corefy field api_second_password -> format: password string -> where to find: issued by your Payway account manager

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "8afec793-9b41-4dc4-b281-c76cc54ffb89",
      "service": "payment_card_uzs",
      "currency": "UZS",
      "amount": 50000,
      "fields": {
        "card_number": "860086******8632"
      }
    }
  }
}

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "06fa1ea9-8a5b-4dbc-b67b-6236b3b9af3d",
      "service": "payment_card_uzs",
      "currency": "UZS",
      "amount": 50000,
      "customer": {
        "reference_id": "cus_123",
        "name": "John Doe"
      },
      "fields": {
        "card_number": "860086******8632"
      }
    }
  }
}

Additional info

1. Only the UZS currency and the payment_card_uzs service are supported - payouts are settled to domestic Uzbekistan cards (Uzcard/Humo). Other currencies/services are rejected.
2. The Test mode toggle does not switch the API host - Corefy always sends requests to the same Payway API endpoint, but selects a different internal routing code for test vs. production payouts.
3. Reconciliation is active: if a payout stays in a non-final state, Corefy queries Payway's status endpoint to resolve it, in addition to processing Payway's asynchronous payout callbacks.
4. Payway strictly enforces unique payout identifiers - resending a payout with a reference_id that was already used is rejected as a duplicate rather than retried, so always use a new reference_id for each payout attempt.
5. Payway does not provide self-service callback configuration - the callback URL for payout notifications has to be requested and set up with Payway's integration team directly.
6. Refunds and recurring payments are not applicable - Payway is a payouts-only connector; Corefy's Payway integration does not support one-time/recurring payments.

FAQ / Troubleshooting

• Invalid credentials / auth error -> verify api_key, api_first_password and api_second_password were issued and entered correctly
• Currency or service is not supported -> Payway only supports payouts in UZS via the payment_card_uzs service
• Payout stuck in Pending -> this is expected while Payway finalizes the payout; Corefy reconciles the final status automatically, avoid resending the same reference_id
• Payout rejected as duplicate -> you reused a reference_id that was already sent to Payway; send a new, unique reference_id
• Not receiving payout callbacks -> confirm the callback URL was registered with Payway's integration team, since this is not self-service