Skip to content

Logo

Blue World (Linx Tech Solutions)

Enable seamless digital transactions, anytime and anywhere

Supports in this guide: Payments, Payouts

Provider website: linxtechsolutions.com

Note

This connector is listed in OFT under the operating company name "Linx Tech Solutions"; the connection itself is branded "Blue World", which is also this doc's blueworld slug.

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

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

Prerequisites: get from Blue World

Send a connection request at linxtechsolutions.com/contact or contact your Blue World account manager directly to get your account verified and receive the following credentials.

  • Merchant ID -> Corefy field merchant_id.
  • Bearer token -> Corefy field bearer_token.

One Provider account is used for both Payments and Payouts. PKR only (JazzCash and EasyPaisa mobile wallets).

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

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • Merchant ID
  • Bearer token

Success

You have connected Blue World Provider account!

First request to Corefy API (MIN)

What it does: creates a payment-invoice. JazzCash and EasyPaisa each support two variants: an HPP redirect (_hpp service) and a direct wallet transfer (_transfer service, requires fields.account_number).

Payment - MIN (HPP redirect)

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "3c4d5e6f-7a8b-4c9d-8e02-3f4a5b6c7d8e",
      "provider_reference_id": "order-3c4d5e6f",
      "service": "jazzcash_pkr_hpp",
      "currency": "PKR",
      "amount": 1000
    }
  }
}

Important

provider_reference_id is required for Payments on this connector - it's sent to Blue World as the order number (orderNo).

Payment - MAX (direct wallet transfer)

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "4d5e6f7a-8b9c-4d0e-8f13-4a5b6c7d8e9f",
      "provider_reference_id": "order-4d5e6f7a",
      "service": "jazzcash_pkr_transfer",
      "currency": "PKR",
      "amount": 1000,
      "customer": {
        "name": "John Doe"
      },
      "fields": {
        "account_number": "03001234567"
      }
    }
  }
}

Important

  • fields.account_number (the JazzCash/EasyPaisa mobile wallet number) is required for the _transfer services; it's not used on the _hpp services.
  • customer.name is sent to Blue World as-is, with no splitting or transliteration.
  • No Options or Constants are configured for Payments.

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

Blue World does not support refunds.

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

Connect Provider account in Corefy Dashboard

Uses the same Provider account connected above - no separate connection step.

First request to Corefy API (MIN)

What it does: creates a payout-invoice and sends funds to a JazzCash or EasyPaisa mobile wallet.

Payout - MIN

POST /api/payout-invoices 

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "5e6f7a8b-9c0d-4e1f-8a02-5b6c7d8e9f0a",
      "provider_reference_id": "payout-5e6f7a8b",
      "service": "jazzcash_pkr",
      "currency": "PKR",
      "amount": 1000,
      "fields": {
        "account_number": "03001234567"
      }
    }
  }
}

Important

  • fields.account_number (the recipient's JazzCash/EasyPaisa mobile wallet number) is required.
  • provider_reference_id is required for Payouts on this connector as well.

Payout - MAX

POST /api/payout-invoices 

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "6f7a8b9c-0d1e-4f20-8b13-6c7d8e9f0a1b",
      "provider_reference_id": "payout-6f7a8b9c",
      "service": "easypaisa_pkr",
      "currency": "PKR",
      "amount": 1000,
      "customer": {
        "name": "John Doe"
      },
      "fields": {
        "account_number": "03001234567"
      }
    }
  }
}

customer.name is sent to Blue World as-is, same as on Payments. No Options or Constants are configured for Payouts.

Additional info

  1. Active reconciliation is available - both Payments and Payouts support an active status request in addition to the asynchronous callback.
  2. No recurring - this connector does not support saving/charging a token through Corefy.

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify the Merchant ID and Bearer token
  • Payment or payout rejected for missing order number -> provider_reference_id is required on both Payments and Payouts for this connector
  • Transfer fails with missing recipient -> fields.account_number is required for the _transfer payment services and for all Payouts
  • Currency or service is not supported -> confirm allowed currencies/features in your Blue World account and in Corefy - only PKR via JazzCash/EasyPaisa is available

Question

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