AsPay

Supports in this guide: Payments, Payouts

Provider website: aspay.us

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

Get your credentials (from AsPay)
Connect in Dashboard
Send an API request

Prerequisites: get from AsPay

Contact your AsPay account manager to get your account verified and receive the following credentials. Payments and Payouts both run on the same Provider account.

API Key -> Corefy field api_key.
Private Key -> Corefy field private_key.

TRY only.

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

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

API Key
Private Key

Success

You have connected AsPay Provider account!

First request to Corefy API (MIN)

What it does: creates a payment-invoice for a card or bank transfer payment via a hosted redirect (HPP). AsPay requires the customer's full name and tax ID (ITN) for every payment.

Payment - MIN

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "7be889b3-ef86-4cd3-b02c-ea01aad2b73b",
      "service": "payment_card_try_hpp",
      "currency": "TRY",
      "amount": 100,
      "customer": {
        "reference_id": "f103d8f1-f2b6-447f-a7fd-960a9e46a713",
        "name": "John Doe",
        "individual_tax_id": "48570756934"
      }
    }
  }
}

Important

customer.name and customer.individual_tax_id are both required - the payment is rejected without calling AsPay if either is missing.
For the card service, customer.name is split into first/last name parts; for the bank transfer service, the full name is sent as a single field.

Payment - MAX

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "9f998e58-bbc9-40a5-b589-72d9cb7df76d",
      "service": "payment_card_try_hpp",
      "currency": "TRY",
      "amount": 100,
      "customer": {
        "reference_id": "dd1b0d54-ada1-40a1-9d18-b8d8e899b65e",
        "name": "John Doe",
        "email": "test@mail.com",
        "phone": "+90787623423",
        "individual_tax_id": "48570756934"
      }
    }
  }
}

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

AsPay does not support refunds.

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

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

API Key
Private Key

Success

You have connected AsPay Provider account!

First request to Corefy API (MIN)

What it does: creates a payout-invoice and sends funds to a bank account via IBAN.

Payout - MIN

POST /api/payout-invoices

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "1d052439-d817-4207-b2bb-4fa25b616967",
      "service": "bank_transfer_try",
      "currency": "TRY",
      "amount": 12,
      "fields": {
        "account_number": "TR100000000000000000000000",
        "beneficiary_full_name": "ADA ELEZ"
      }
    }
  }
}

Important

fields.account_number (IBAN) and fields.beneficiary_full_name are both required.

Payout - MAX

POST /api/payout-invoices

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "aa86e9e6-373d-45f8-9cbf-a0c83e43282c",
      "service": "bank_transfer_try",
      "currency": "TRY",
      "amount": 12,
      "customer": {
        "reference_id": "3254797a-4fc6-44e5-8a5f-bbbd30188f18",
        "individual_tax_id": "48570756934",
        "phone": "90123456789"
      },
      "fields": {
        "account_number": "TR100000000000000000000000",
        "beneficiary_full_name": "ADA ELEZ"
      }
    }
  }
}

customer.individual_tax_id and customer.phone are both optional for payouts and are forwarded to AsPay when present.

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

AsPay does not support refunds for payouts.

Additional info

Single account type - AsPay has only one connection type (Provider account), used for both Payments and Payouts; there is no H2H Merchant account.
No refunds - neither Payments nor Payouts support refunds on this connector.
TRY only - card, bank transfer payments, and bank transfer payouts are all limited to Turkish Lira.

FAQ / Troubleshooting

Invalid credentials / auth error -> verify the API Key and Private Key for the selected environment
Payment rejected before reaching AsPay -> customer.name or customer.individual_tax_id is missing - both are required for every payment
Currency or service is not supported -> confirm allowed currencies/features in your AsPay account and in Corefy - only TRY is available
Refund request fails -> AsPay does not support refunds on either Payments or Payouts

Question

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