Skip to content

Logo

Paysafebd

Supports in this guide: Payments, Payouts

Provider website: paysafebd.com


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

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

Prerequisites: get from Paysafebd

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

  • Merchant ID -> Corefy field merchant_id.
  • Merchant Key -> Corefy field merchant_key - used to sign Payment requests; needed if you plan to process Payments.
  • Secret Key -> Corefy field secret_key - used together with Merchant Key to verify the payment callback signature.
  • Payout Key -> Corefy field payout_key - used to sign Payout requests; needed if you plan to process Payouts.

Currencies: INR only, across two local real-time methods - UPI and IMPS.


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

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • Merchant ID
  • Merchant Key
  • Secret Key
  • Payout Key -> optional if you only process Payments
  • Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected Paysafebd Provider account!


First request to Corefy API

What it does: creates a payment-invoice and redirects the payer to Paysafebd's own hosted page, where the UPI or IMPS payment is completed. Paysafebd's gateway does not read any customer/address data from this request - the fields below are everything that's needed.

Payment - UPI

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "6be05631-8710-4b14-a369-1928a2b70eda",
      "service": "upi_inr_hpp",
      "currency": "INR",
      "amount": 100
    }
  }
}

Payment - IMPS

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "199be985-c243-478a-86a8-4b8c902e5bb6",
      "service": "imps_inr_hpp",
      "currency": "INR",
      "amount": 100
    }
  }
}


Refunds

Paysafebd does not support refunds on Payments.

Recurring

Paysafebd does not support recurring/token payments.


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

What it does: creates a payout-invoice for a UPI or IMPS payout. The required fields differ per method.

Payout - UPI

POST /api/payout-invoices

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "fa3a05f3-f923-48ab-a95c-9f894cc12277",
      "service": "upi_inr",
      "currency": "INR",
      "amount": 843.13,
      "fields": {
        "vpa": "test@test",
        "beneficiary_full_name": "John Doe"
      }
    }
  }
}

Payout - IMPS

POST /api/payout-invoices

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "4f2c3801-6a6a-46c7-8031-78cc599baf50",
      "service": "imps_inr",
      "currency": "INR",
      "amount": 862.32,
      "fields": {
        "vpa": "test@test",
        "ifsc": "123456",
        "account_holder_full_name": "John Doe"
      }
    }
  }
}

Important

  • fields.vpa is required for both methods.
  • IMPS payouts additionally require fields.ifsc and fields.account_holder_full_name.
  • UPI payouts additionally require fields.beneficiary_full_name.

Refunds

Not applicable to Payouts.

Recurring

Not applicable to Payouts.


Additional info

  1. Provider account only - Paysafebd has a single connection flow (Provider account); there is no H2H Merchant account option for this connector.
  2. Active reconciliation is available on both flows - besides the asynchronous callback, Corefy can also actively request the current status of a Payment or Payout from Paysafebd and finalize it from that response.
  3. No refunds - neither Payments nor Payouts support refunds.
  4. No recurring - this connector does not support saving/charging a token through Corefy.
  5. Only INR is supported, for both Payments and Payouts, across the UPI and IMPS methods.

FAQ / Troubleshooting

  • Invalid credentials / auth error on Payments -> verify Merchant ID and Merchant Key match the selected environment (test_mode)
  • Invalid credentials / auth error on Payouts -> verify Merchant ID and Payout Key match the selected environment (test_mode)
  • Payout fails for IMPS -> make sure fields.ifsc and fields.account_holder_full_name are both sent together with fields.vpa
  • Callback signature mismatch -> Secret Key and Merchant Key must both be set correctly; the callback signature is derived from both

Question

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