Save InstaPay credentials

PUT

https://numueg.app/api/v1/stores/{store_id}/settings/payment/instapay/credentials

Last modified:2026-09-19 16:39:33

x-numu-scope:settings:write

Save InstaPay configuration for the store.

The IPA + fallback phone are encrypted at rest; the auto-approval
thresholds sit alongside the encrypted blob in plaintext because
they're policy knobs the merchant sees in the dashboard, not
secrets.

request.ipa and request.fallback_phone are both optional — when
omitted, the existing encrypted blob is decrypted and those values
carry forward. This lets the merchant edit display name, thresholds,
or toggle enabled without re-typing the IPA (the UI shows it masked;
it can never unmask to its true form). First-time saves must include
ipa, and it is now format-checked (name@bank) — a typo'd IPA
silently misroutes a customer's money.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Successful Response

Bodyapplication/json

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://numueg.app/api/v1/stores//settings/payment/instapay/credentials' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "ipa": "string",
    "ipa_display_name": "string",
    "fallback_phone": "string",
    "auto_approve_enabled": true,
    "auto_approve_threshold_cents": 50000,
    "auto_approve_daily_cap_cents": 500000,
    "auto_approve_daily_count": 10,
    "qr_link_url": "string",
    "require_ocr_amount_match": false,
    "require_ocr_ipa_match": false,
    "ocr_amount_tolerance_bps": 100,
    "require_note_contains_reference": false,
    "require_transaction_ref_match": false,
    "require_recipient_name_match": false,
    "recipient_name_token": "string"
}'

Response Example

200 - Example 1

{
    "success": true,
    "data": {
        "is_configured": true,
        "enabled": false,
        "ipa_masked": "string",
        "ipa_display_name": "string",
        "fallback_phone": "string",
        "auto_approve_enabled": true,
        "auto_approve_threshold_cents": 0,
        "auto_approve_daily_cap_cents": 0,
        "auto_approve_daily_count": 0,
        "last_configured": "string",
        "qr_image_url": "string",
        "qr_link_url": "string",
        "ocr_provider": "string",
        "require_ocr_amount_match": false,
        "require_ocr_ipa_match": false,
        "ocr_amount_tolerance_bps": 100,
        "require_note_contains_reference": false,
        "require_transaction_ref_match": false,
        "require_recipient_name_match": false,
        "recipient_name_token": "string"
    },
    "message": "string"
}

Modified at 2026-09-19 16:39:33

Update checkout fields config

Get InstaPay credentials status