Skip to content

Logo

Siru Mobile

World's easiest mobile payment

Supports in this guide: Payments

Provider website: sirumobile.com

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

  1. Get your credentials (from Siru Mobile)
  2. Set your connection Constants
  3. Connect in Dashboard
  4. Send an API request

Prerequisites: get from Siru Mobile

Contact your Siru Mobile account manager to get your account verified and receive the following credentials.

  • Merchant ID -> Corefy field merchant_id.
  • Secret Key -> Corefy field secret_key -> used to sign every request.
  • External Account ID (optional) -> Corefy field external_account_id -> only needed if your Siru Mobile merchant has multiple sub-accounts and you need to identify a specific one.

Important

Siru Mobile charges the customer's own mobile phone bill - there's no card or bank account involved. The Variant Constant must be set for the connection to work (see Constants below).

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

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • Merchant ID
  • Secret Key
  • External Account ID (optional)
  • Test Mode -> (enable if you are using sandbox credentials)

For each service you plan to use, fill in the Variant Constant (required) and the other Constants relevant to your service - see below.

Success

You have connected Siru Mobile Provider account!

First request to Corefy API (MIN)

What it does: creates a payment-invoice and redirects the customer to a Siru Mobile-hosted page to confirm the charge against their mobile phone bill. Available in Finland (EUR) and Sweden (SEK).

Payment - MIN

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "1f2a3b4c-5d6e-4f70-8a81-2b3c4d5e6f7a",
      "service": "siru_mobile_eur_hpp",
      "currency": "EUR",
      "amount": 10
    }
  }
}

This connector also supports siru_mobile_sek_hpp (SEK).

Payment - MAX

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "2a3b4c5d-6e7f-4a81-8b92-3c4d5e6f7a8b",
      "service": "siru_mobile_eur_hpp",
      "currency": "EUR",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123",
        "name": "John Smith",
        "email": "johnsmith@gmail.com",
        "phone": "+358401234567",
        "address": {
          "country": "FI"
        }
      },
      "fields": {
        "personal_id": "010190-1234"
      }
    }
  }
}

Important

  • customer.phone is the customer's own mobile number being charged - send it in the format Siru Mobile expects for the purchase country.
  • customer.address.country selects the purchase country (FI/SE); falls back to the purchase_country Constant if missing.
  • fields.personal_id is optional - the customer's national personal ID, used by Siru Mobile for age/identity verification where required.
  • customer.email, customer.name (first/last) are forwarded as-is with no Constants fallback.

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

No Options are configured for this connector.

Constants

Unlike most connectors, variant isn't a fallback value - it's always read from this Constant and is required for the connection to work. purchase_country is a true fallback, used only when customer.address.country is missing. service_group and tax_class (EUR/Finland only) classify the type of digital good/service being sold, per Siru Mobile's own categories.

Available constants (Finland - siru_mobile_eur_hpp)

  • variant -> required -> one of Siru Mobile's payment flow variants; confirm with your account manager which applies to your account.
  • service_group -> one of 1, 2, 3, 4.
  • tax_class -> one of 0, 1, 2, 3.
  • purchase_country -> fallback for customer.address.country (FI/SE).

Available constants (Sweden - siru_mobile_sek_hpp)

  • variant -> required -> same as above.
  • purchase_country -> fallback for customer.address.country (FI/SE).

Refunds

This connector does not support refunds.

Additional info

  1. Callback routing is automatic - Corefy generates the callback/return URLs per transaction, nothing to configure in Siru Mobile's own back-office.
  2. Active reconciliation is available - Payments support an active status request, in addition to the asynchronous callback.
  3. No payouts - this connector does not support payouts through Corefy.

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify Merchant ID/Secret Key (and External Account ID, if your account uses sub-accounts) for the selected environment
  • Connection rejects with an unexpected variant error -> make sure the variant Constant is set to one of Siru Mobile's supported values for your account
  • Refund request fails -> refunds aren't supported by this connector
  • Currency or service is not supported -> confirm allowed currencies in your Siru Mobile account and in Corefy - only EUR (Finland) and SEK (Sweden) are available

Question

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