Skip to content

Logo

AraPay

Accept payments worldwide. Without the bureaucracy.

Supports in this guide: Payments

Provider website: arapay.net


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

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

Prerequisites: get from AraPay

Contact your AraPay account manager (or sign up at arapay.net) to get your account verified and receive the following credentials:

  • API key -> Corefy field api_key.
  • Signature secret -> Corefy field sign_secret -> used to sign outgoing requests and to verify incoming webhooks.
  • API URL (optional) -> Corefy field api_url -> leave as default unless your account manager tells you otherwise.

Payments processing (connect Provider account, create payment-invoice)

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • API key
  • Signature secret
  • API URL (optional)
  • Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected AraPay Provider account!


First request to Corefy API (MIN)

What it does: creates a payment-invoice. AraPay supports two distinct methods on this same connection:

  • Card transfer (P2P) - AraPay returns a card number and cardholder name for the customer to transfer funds to directly; no redirect is involved.
  • Card (acquiring) - the customer is redirected to an AraPay-hosted payment page to enter their card details.

Neither method accepts customer fields - AraPay's API does not use any customer data, only the amount, currency, and your reference ID.

Payment - MIN (card transfer / P2P)

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "1f2aa3ca-abd8-4741-980d-4017ed30cb8c",
      "service": "card_transfer_uah_invoice",
      "currency": "UAH",
      "amount": 5
    }
  }
}

Important

The response returns the card number and cardholder name (and bank name, when available) for the customer to transfer the payment amount to. Corefy does not require any further action from the merchant - the payment is finalized via callback or reconciliation once AraPay detects the transfer.

Payment - MIN (card acquiring / HPP)

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "2b3c4d5e-6f7a-4b8c-8d02-3e4f5a6b7c8d",
      "service": "payment_card_uah_hpp",
      "currency": "UAH",
      "amount": 5
    }
  }
}

Note

Exact service codes depend on the currencies/methods enabled for your account - confirm them with your account manager or in the Dashboard connection form.


Options

This connector has no configurable options - AraPay does not accept constants, customer data, or extra request fields on either method.


Additional info

  1. No constants or customer data - AraPay's API only uses the amount, currency, and your reference ID; there is nothing to map via Constants.
  2. Callbacks and reconciliation - AraPay sends a signed webhook (verified automatically by Corefy using your sign_secret), and an active status request is also available for reconciliation.
  3. No refunds - this connector does not support refunds.
  4. No recurring - this connector does not support saving/charging a token through Corefy.

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify the API key, signature secret, and environment (test_mode)
  • Webhook signature mismatch -> confirm the sign_secret in Corefy matches the one issued by AraPay
  • Currency or service is not supported -> confirm allowed currencies/methods in your AraPay account and in Corefy
  • Duplicate order error -> AraPay rejects a second order created with the same reference_id; use a unique reference per payment

Question

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