feat(connector): GrabPay connector integration by peeyushshukla-juspay · Pull Request #2063 · juspay/hyperswitch-prism

peeyushshukla-juspay · 2026-08-05T07:27:26Z

Description

Adds the GrabPay one-time-charge redirect wallet connector with Create Order, OAuth authorization, redirect verification, payment sync, refund, and refund sync support.

Flows Implemented

Flow	Service Method	Status
Create Order / Authorize	`types.CompositePaymentService/Authorize`	Creates the GrabPay charge and returns the OAuth redirect URL
Verify Redirect Response	`types.CompositePaymentService/VerifyRedirectResponse`	Exchanges the OAuth code and completes the charge
PSync	`types.CompositePaymentService/Get`	Queries the payment status
Refund	`types.CompositePaymentService/Refund`	Processes full and partial refunds
RSync	`types.CompositeRefundService/Get`	Queries the refund status
Webhook	`types.EventService/HandleEvent`	GrabPay webhook handler

Additional Changes

This PR modifies the API contract by adding the GrabPay connector, GRAB_PAY payment method type, and grabpayRedirect wallet data.
This PR modifies connector configuration by adding GrabPay credentials and base URL configuration.
Redirect connector feature data is propagated through the composite flow to preserve PKCE, transaction, currency, and access-token context.

Testing

1. Authorize - Redirect Pending

grpcurl -plaintext \
  -H 'x-connector: grabpay' \
  -H 'x-connector-config: {"config":{"Grabpay":{"partner_id":"<REDACTED>","partner_secret":"<REDACTED>","client_id":"<REDACTED>","client_secret":"<REDACTED>","merchant_id":"<REDACTED>","base_url":"https://partner-api.grab.com/grabpay/partner/v2"}}}' \
  -d '{
    "merchantTransactionId": "<REDACTED_TRANSACTION_ID>",
    "merchantOrderId": "<REDACTED_TRANSACTION_ID>",
    "amount": {
      "minorAmount": 1,
      "currency": "PHP"
    },
    "paymentMethod": {
      "grabpayRedirect": {}
    },
    "captureMethod": "AUTOMATIC",
    "authType": "NO_THREE_DS",
    "returnUrl": "https://example.com/payment/response",
    "webhookUrl": "https://example.com/webhook",
    "description": "GrabPay test payment",
    "address": {
      "billingAddress": {
        "countryAlpha2Code": "PH"
      }
    },
    "testMode": false
  }' \
  localhost:8000 \
  types.CompositePaymentService/Authorize

Response:

{
  "authorizeResponse": {
    "connectorTransactionId": "<REDACTED_TRANSACTION_ID>",
    "status": "AUTHENTICATION_PENDING",
    "statusCode": 302,
    "redirectionData": {
      "uri": {
        "uri": "https://partner-api.grab.com/grabid/v1/oauth2/authorize?<REDACTED>"
      }
    },
    "connectorFeatureData": {
      "value": "{\"state\":\"<REDACTED>\",\"nonce\":\"<REDACTED>\",\"code_verifier\":\"<REDACTED>\",\"redirect_uri\":\"https://example.com/payment/response\",\"partner_tx_id\":\"<REDACTED_TRANSACTION_ID>\",\"currency\":\"PHP\",\"request_code\":\"<REDACTED>\"}"
    }
  },
  "createOrderResponse": {
    "connectorOrderId": "<REDACTED_REQUEST_CODE>",
    "status": "PENDING",
    "statusCode": 200
  },
  "compositeStatus": "COMPLETED"
}

2. Verify Redirect Response - Charge Success

grpcurl -plaintext \
  -H 'x-connector: grabpay' \
  -H 'x-connector-config: {"config":{"Grabpay":{"partner_id":"<REDACTED>","partner_secret":"<REDACTED>","client_id":"<REDACTED>","client_secret":"<REDACTED>","merchant_id":"<REDACTED>","base_url":"https://partner-api.grab.com/grabpay/partner/v2"}}}' \
  -d '{
    "merchantTransactionId": "<REDACTED_TRANSACTION_ID>",
    "merchantOrderId": "<REDACTED_TRANSACTION_ID>",
    "connectorOrderId": "<REDACTED_REQUEST_CODE>",
    "requestDetails": {
      "queryParams": "code=<REDACTED>&state=<REDACTED>"
    },
    "connectorFeatureData": {
      "value": "{\"state\":\"<REDACTED>\",\"nonce\":\"<REDACTED>\",\"code_verifier\":\"<REDACTED>\",\"redirect_uri\":\"https://example.com/payment/response\",\"partner_tx_id\":\"<REDACTED_TRANSACTION_ID>\",\"currency\":\"PHP\",\"request_code\":\"<REDACTED>\"}"
    },
    "amount": {
      "minorAmount": 1,
      "currency": "PHP"
    },
    "paymentMethod": {
      "grabpayRedirect": {}
    },
    "captureMethod": "AUTOMATIC",
    "address": {
      "billingAddress": {
        "countryAlpha2Code": "PH"
      }
    },
    "returnUrl": "https://example.com/payment/response",
    "testMode": false
  }' \
  localhost:8000 \
  types.CompositePaymentService/VerifyRedirectResponse

Response:

{
  "verifyRedirectResponse": {
    "rawConnectorResponse": {
      "value": "{\"code\":\"<REDACTED>\",\"state\":\"<REDACTED>\",\"error\":null}"
    },
    "connectorFeatureData": {
      "value": "<REDACTED_CONNECTOR_FEATURE_DATA>"
    }
  },
  "accessTokenResponse": {
    "accessToken": {
      "value": "<REDACTED_ACCESS_TOKEN>"
    },
    "tokenType": "Bearer",
    "expiresInSeconds": "31535999",
    "status": "OPERATION_STATUS_SUCCESS",
    "statusCode": 200
  },
  "authorizeResponse": {
    "connectorTransactionId": "<REDACTED_CONNECTOR_TRANSACTION_ID>",
    "status": "CHARGED",
    "statusCode": 200,
    "connectorFeatureData": {
      "value": "{\"txID\":\"<REDACTED_CONNECTOR_TRANSACTION_ID>\",\"status\":\"success\",\"paymentMethod\":\"GPWALLET\",\"description\":\"\",\"reason\":\"\"}"
    }
  }
}

3. Payment Sync - Success

grpcurl -plaintext \
  -H 'x-connector: grabpay' \
  -H 'x-connector-config: {"config":{"Grabpay":{"partner_id":"<REDACTED>","partner_secret":"<REDACTED>","client_id":"<REDACTED>","client_secret":"<REDACTED>","merchant_id":"<REDACTED>","base_url":"https://partner-api.grab.com/grabpay/partner/v2"}}}' \
  -d '{
    "connectorTransactionId": "<REDACTED_CONNECTOR_TRANSACTION_ID>",
    "merchantTransactionId": "<REDACTED_TRANSACTION_ID>",
    "state": {
      "accessToken": {
        "token": {
          "value": "<REDACTED_ACCESS_TOKEN>"
        },
        "expiresInSeconds": "31535999",
        "tokenType": "Bearer"
      }
    },
    "amount": {
      "minorAmount": 1,
      "currency": "PHP"
    },
    "paymentMethod": {
      "grabpayRedirect": {}
    },
    "paymentMethodType": "GRAB_PAY",
    "testMode": false
  }' \
  localhost:8000 \
  types.CompositePaymentService/Get

Response:

{
  "getResponse": {
    "connectorTransactionId": "<REDACTED_CONNECTOR_TRANSACTION_ID>",
    "status": "CHARGED",
    "statusCode": 200,
    "amount": {
      "minorAmount": "1",
      "currency": "PHP"
    },
    "connectorFeatureData": {
      "value": "{\"txID\":\"<REDACTED_CONNECTOR_TRANSACTION_ID>\",\"status\":\"success\",\"paymentMethod\":\"GPWALLET\",\"description\":\"\",\"txStatus\":\"success\",\"reason\":\"\"}"
    }
  }
}

4. Refund - Success

grpcurl -plaintext \
  -H 'x-connector: grabpay' \
  -H 'x-connector-config: {"config":{"Grabpay":{"partner_id":"<REDACTED>","partner_secret":"<REDACTED>","client_id":"<REDACTED>","client_secret":"<REDACTED>","merchant_id":"<REDACTED>","base_url":"https://partner-api.grab.com/grabpay/partner/v2"}}}' \
  -d '{
    "merchantRefundId": "<REDACTED_REFUND_ID>",
    "connectorTransactionId": "<REDACTED_TRANSACTION_ID>",
    "connectorOrderId": "<REDACTED_CONNECTOR_TRANSACTION_ID>",
    "paymentAmount": 100,
    "refundAmount": {
      "minorAmount": 1,
      "currency": "PHP"
    },
    "reason": "GrabPay test refund",
    "state": {
      "accessToken": {
        "token": {
          "value": "<REDACTED_ACCESS_TOKEN>"
        },
        "expiresInSeconds": "31535999",
        "tokenType": "Bearer"
      }
    },
    "paymentMethodType": "GRAB_PAY",
    "paymentMethod": {
      "grabpayRedirect": {}
    },
    "testMode": false
  }' \
  localhost:8000 \
  types.CompositePaymentService/Refund

Response:

{
  "refundResponse": {
    "connectorRefundId": "<REDACTED_REFUND_ID>",
    "status": "REFUND_SUCCESS",
    "statusCode": 200,
    "connectorTransactionId": "<REDACTED_TRANSACTION_ID>",
    "rawConnectorResponse": {
      "value": "{\"txID\":\"<REDACTED_CONNECTOR_REFUND_TRANSACTION_ID>\",\"status\":\"success\",\"paymentMethod\":\"GPWALLET\",\"description\":\"\",\"txStatus\":\"success\",\"reason\":\"\",\"echo\":null}"
    }
  }
}

5. Refund Sync - Success

grpcurl -plaintext \
  -H 'x-connector: grabpay' \
  -H 'x-connector-config: {"config":{"Grabpay":{"partner_id":"<REDACTED>","partner_secret":"<REDACTED>","client_id":"<REDACTED>","client_secret":"<REDACTED>","merchant_id":"<REDACTED>","base_url":"https://partner-api.grab.com/grabpay/partner/v2"}}}' \
  -d '{
    "connectorTransactionId": "<REDACTED_TRANSACTION_ID>",
    "refundId": "<REDACTED_REFUND_ID>",
    "connectorRefundId": "<REDACTED_REFUND_ID>",
    "refundAmount": {
      "minorAmount": 1,
      "currency": "PHP"
    },
    "state": {
      "accessToken": {
        "token": {
          "value": "<REDACTED_ACCESS_TOKEN>"
        },
        "expiresInSeconds": "31535999",
        "tokenType": "Bearer"
      }
    },
    "paymentMethodType": "GRAB_PAY",
    "paymentMethod": {
      "grabpayRedirect": {}
    },
    "testMode": false
  }' \
  localhost:8000 \
  types.CompositeRefundService/Get

Response:

{
  "refundResponse": {
    "merchantRefundId": "<REDACTED_REFUND_ID>",
    "connectorRefundId": "<REDACTED_REFUND_ID>",
    "status": "REFUND_SUCCESS",
    "statusCode": 200,
    "connectorTransactionId": "<REDACTED_TRANSACTION_ID>",
    "rawConnectorResponse": {
      "value": "{\"txID\":\"<REDACTED_CONNECTOR_REFUND_TRANSACTION_ID>\",\"status\":\"success\",\"paymentMethod\":\"GPWALLET\",\"description\":\"\",\"txStatus\":\"success\",\"reason\":\"\",\"echo\":null}"
    }
  }
}

Validation

cargo fmt --check
cargo test -p connector-integration -- grabpay
cargo check -p connector-integration -p composite-service -p grpc-server

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

shuklatushar226

check base url once

…status, specs, and redirect errors

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

feat(grabpay): add GrabPay connector integration

5c9319e

peeyushshukla-juspay requested review from a team as code owners August 5, 2026 07:27

peeyushshukla-juspay and others added 25 commits August 5, 2026 13:49

fix(grabpay): add connector specs and clippy fixes

02f7cb3

chore: auto-fix formatting and generated code

820b7eb

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

chore: auto-fix formatting and generated code

6679297

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

chore: auto-fix formatting and generated code

460b7e4

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

chore: auto-fix formatting and generated code

1870d4b

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

chore: auto-fix formatting and generated code

2a23b02

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

chore: auto-fix formatting and generated code

0eda3dc

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

chore: auto-fix formatting and generated code

d99f3ae

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

chore: auto-fix formatting and generated code

bd0979d

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

chore: auto-fix formatting and generated code

1ae3426

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

chore: auto-fix formatting and generated code

458c8b9

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

chore: auto-fix formatting and generated code

372f0f3

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

chore: auto-fix formatting and generated code

8366f42

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

chore: auto-fix formatting and generated code

a31f46f

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

chore: auto-fix formatting and generated code

f58641d

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

chore: auto-fix formatting and generated code

41ecd33

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

chore: auto-fix formatting and generated code

a33844a

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

chore: auto-fix formatting and generated code

2ede596

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

chore: auto-fix formatting and generated code

5187870

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

chore: auto-fix formatting and generated code

67d2515

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

chore: auto-fix formatting and generated code

3ec3942

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

chore: auto-fix formatting and generated code

415481e

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

chore: auto-fix formatting and generated code

f658dbb

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

chore: auto-fix formatting and generated code

6e1baa3

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

chore: auto-fix formatting and generated code

25be74c

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

chore: auto-fix formatting and generated code

8839a9a

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

hyperswitch-bot Bot dismissed kanikac199’s stale review via 8839a9a August 8, 2026 10:54

Aishwariyaa-Anand previously approved these changes Aug 8, 2026

View reviewed changes

JeevaRamu0104 reviewed Aug 10, 2026

View reviewed changes

chore: resolved comments

9e2b975

peeyushshukla-juspay dismissed Aishwariyaa-Anand’s stale review via 9e2b975 August 10, 2026 12:36

kanikac199 previously approved these changes Aug 10, 2026

View reviewed changes

Aishwariyaa-Anand previously approved these changes Aug 10, 2026

View reviewed changes

peeyushshukla-juspay requested a review from JeevaRamu0104 August 10, 2026 12:49

chore: auto-fix formatting and generated code

aa26ff8

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

hyperswitch-bot Bot dismissed stale reviews from Aishwariyaa-Anand and kanikac199 via aa26ff8 August 10, 2026 12:57

kanikac199 previously approved these changes Aug 10, 2026

View reviewed changes

shuklatushar226 previously approved these changes Aug 10, 2026

View reviewed changes

Comment thread config/sandbox.toml

Aishwariyaa-Anand previously approved these changes Aug 10, 2026

View reviewed changes

JeevaRamu0104 requested changes Aug 10, 2026

View reviewed changes

fix(grabpay): address review comments on connector metadata, webhook …

55e3205

…status, specs, and redirect errors

peeyushshukla-juspay dismissed stale reviews from Aishwariyaa-Anand, shuklatushar226, and kanikac199 via 55e3205 August 11, 2026 07:12

chore: auto-fix formatting and generated code

cf027f1

Auto-applied by CI: - cargo +nightly fmt --all - make -C sdk generate (if applicable) - make docs (if applicable) This commit was automatically generated by GitHub Actions.

JeevaRamu0104 approved these changes Aug 11, 2026

View reviewed changes

Aishwariyaa-Anand approved these changes Aug 11, 2026

View reviewed changes

Aishwariyaa-Anand enabled auto-merge August 11, 2026 07:57

kanikac199 approved these changes Aug 11, 2026

View reviewed changes

shuklatushar226 approved these changes Aug 11, 2026

View reviewed changes

Aishwariyaa-Anand added this pull request to the merge queue Aug 11, 2026

Merged via the queue into main with commit aefd947 Aug 11, 2026
19 checks passed

Aishwariyaa-Anand deleted the Grabpay_Connector_Integration branch August 11, 2026 08:48

Navigation Menu

Uh oh!

feat(connector): GrabPay connector integration - #2063

feat(connector): GrabPay connector integration#2063
Aishwariyaa-Anand merged 89 commits into
mainfrom
Grabpay_Connector_Integration

peeyushshukla-juspay commented Aug 5, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

shuklatushar226 left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

Uh oh!

Conversation

peeyushshukla-juspay commented Aug 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Flows Implemented

Additional Changes

Testing

Validation

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

shuklatushar226 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

peeyushshukla-juspay commented Aug 5, 2026 •

edited

Loading