Payment Gateway Integrations

YES_BIZ

Step 1 - Procure Gateway Credentials

Obtain the merchant credentials from the YES_BIZ team for Sandbox (testing) and Production (live).

Please find below a sample format of credentials that you can expect from the gateway

  • MerchantId : S****UAT

  • ChannelId: S****UATPP

  • MCC: 5**5

  • VPA: s***uat@ypay

  • Yes Biz Public Key: Upload the Public Key provided by the YES_BIZ team

Note

The fields marked * are mandatory and are required to be configured to proceed with the testing. Rest of the fields are optional and only required for specific features/flows.

Step 2 - Dashboard Configuration

  • Open up the Juspay Portal

  • Navigate to Payments → PG Control Centre

  • Select YES_BIZ under the “Add a Payment Gateway (PG)" section

  • Select an environment for the payment gateway. If not sure then confirm with YES_BIZ team whether the credentials provided by them are for testing or production usage

    • Live Environment: Real money involved, all flows supported

    • Testing Environment: Simulate payments, only some flows are supported

  • Gateway Reference ID: For most cases you don’t need this but if you do then refer https://juspay.io/in/docs/hyper-checkout/android/resources/gateway-reference-idlink icon

Step 3 - Flag Enablement Email to PG

An email titled “Juspay <> YES_BIZ PG Merchant Enablement for MID - {Your Yes_biz MID} (Juspay ID: 123456)“ will be triggered from our dashboard for various flag enablements at PG end.

Step 4 - Payment Methods Configuration

Configure the payment methods as per your business needs using the Juspay Dashboard. Enable or disable payment methods your business will accept through YES_BIZ on this screen.

Step 5 - Advanced Feature Flags (Optional)

Following Advanced Feature Flags are available under YES_BIZ:

  • enableBankInstantRefund: For instant refunds of NB transactions

  • Gpay Merchant Id: MerchantId to initiate OMNICHANNEL/PUSH_PAY transaction with googlePay.

  • Intent Expiry in Seconds: the amount of time for which UPI intent stays active. (default value is set to 5 minutes)

  • Waiting Page Expiry in Seconds: The amount of time for which the waiting page for transaction terminal state is shown. (Default value is set to 30 minutes)

  • Prefix: This is a transaction ID prefix sent to the PG for UPI transactions.

  • Bank Instant Refund: Enable Bank Instant Refund

  • Emandate: Enabling this flag would allow mandate payments with payment instruments other than CARD

  • One Time Mandate: Enabling this flag would enable the flow where money is blocked in User's account and one debit takes place post which Mandate expires.

  • Split Settlement: Enabling this flag allows Settling the transaction amount into multiple aquiring bank accounts

  • Use Transaction UUID as TR: Enabling this field would mean that the TR parameter in YES_BIZ APIs would have the value of the UUID generated at Juspay end. This flag is introduced so that character limit constraints at gateway can be maintained without any change from your end.

Step 6 - Configure Juspay URLs at Gateway

Refer to the Webhook Section to get the list of Juspay URLs that need to be whitelisted at the gateway end.

Step 7 - Testing

Test all payment flows using the sandbox environment. Ensure that all enabled payment methods work as expected and the callbacks are received correctly.

Step 8 - Go live

Switch your configuration to production credentials on Juspay Dashboard after thorough testing, and inform gateway to enable your production credentials if required.

Last updated 3 months ago