Skip to content

AsuPay

Supports in this guide: Payments, Payouts

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

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

Choose account type

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

  • If you do card payments -> choose H2H Merchant account
  • If you do card payouts -> choose Provider account

AsuPay does not currently support payments through a Provider account, or payouts through the H2H Merchant account. If you're not sure which one to use, confirm with your Corefy account manager.

Prerequisites: get from AsuPay

Contact your AsuPay account manager to get your account verified and receive the following credentials. H2H Merchant account and Provider account are separate connections, but both use the same credential set.

  • Merchant ID -> Corefy field merchant_id.
  • Username -> Corefy field username.
  • Password -> Corefy field password.
  • Secret key -> Corefy field secret_key.

AZN only.

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

Connect H2H Merchant account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • Merchant ID
  • Username
  • Password
  • Secret key

Success

You have connected AsuPay 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. AsuPay does not support 3D Secure or non-CVV payments - the CVV is always required.

Payment - MIN

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "1a2b3c4d-5e6f-4a7b-8c91-2d3e4f5a6b7c",
      "service": "payment_card_azn",
      "currency": "AZN",
      "amount": 10
    }
  }
}

Payment - MAX

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "2b3c4d5e-6f7a-4b8c-8d02-3e4f5a6b7c8d",
      "service": "payment_card_azn",
      "currency": "AZN",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123",
        "name": "John Doe"
      }
    }
  }
}

Important

customer.name is sent to AsuPay as the cardholder name. No Constants are configured for this connector - if customer.name is missing, the card's own cardholder name (if available) is used 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

AsuPay does not support refunds.

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

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • Merchant ID
  • Username
  • Password
  • Secret key

Success

You have connected AsuPay 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": "3c4d5e6f-7a8b-4c9d-8e02-3f4a5b6c7d8e",
      "service": "payment_card_azn",
      "currency": "AZN",
      "amount": 10,
      "context": {
        "card": {
          "card_holder": "JOHN DOE",
          "exp_month": "12",
          "exp_year": "29"
        }
      },
      "fields": {
        "card_number": "4111111111111111"
      }
    }
  }
}

Important

fields.card_number, context.card.card_holder, context.card.exp_month and context.card.exp_year are all required - AsuPay rejects the payout upfront if any of them is missing.

Extended request (MAX)

This connector has no optional fields beyond the MIN example above - the card details are the only data AsuPay needs for a payout.

AsuPay does not support refunds.

Additional info

  1. Callbacks and reconciliation - AsuPay sends callbacks for both Payments and Payouts, and Corefy also supports an active status request for both flows.
  2. No recurring - this connector does not support saving/charging a token through Corefy.

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify merchant_id, username, password and secret_key - the same credentials are used for both account types
  • Payout rejected immediately -> make sure fields.card_number, context.card.card_holder, context.card.exp_month and context.card.exp_year are all present in the request
  • Currency or service is not supported -> AsuPay only supports AZN; confirm this is enabled for your account in Corefy
  • Not sure which account type to use? -> H2H Merchant account is for Payments; Provider account is for card Payouts

Question

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