Update Card Preferences

Update the limits & preferences on the debit card

You can set a user's daily transaction limit and ATM withdrawal limit per card number. These numbers can be updated on your end dynamically as needed. For every card number, you can also set whether to allow foreign transactions by passing in a boolean value.

API ENDPOINT

https://uat-api.synapsefi.com/v3.1/users/:user_id/nodes/:node_id/subnets/:subnet_id

PATH PARAMETER

user_id :
required
string

The user ID of the user

node_id :
required
string

The ID of the node the card number was issued to

subnet_id:
required
string

The ID of the subnet (card number)

BODY PARAMETER

preferences.allow_foreign_transactions:
boolean

Allow foreign transaction on card

preferences.daily_atm_withdrawal_limit:
integer

Max atm withdraw limit for debit card

preferences.daily_transaction_limit :
integer

Daily transaction limit for debit card

Use cases for updating ‘Preferences’:

  • You want to modify a user’s daily_transaction_limit and daily_atm_withdrawal_limit as you have more account history.
  • If you anticipate cards being used outside of US, please make sure preferences.allow_foreign_transactions is set to true.

EXAMPLE REQUEST

PATCH /v3.1/users/5bb29f48520da000a38cb107/nodes/5bb29f5471fd1b0091317410/subnets/5bc920f2fff373002bf0d51b
HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_NhFV8tDKOMms2j5I4lzxJXUQY9BH6abycdnpTCA3|J6fhD7DNd238
Content-Type: application/json

{
    "preferences": {
      "allow_foreign_transactions":true,
      "daily_atm_withdrawal_limit":10,
      "daily_transaction_limit":1000
    }
}
node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'
body = {
  "preferences": {
    "allow_foreign_transactions":true,
    "daily_atm_withdrawal_limit":10,
    "daily_transaction_limit":1000
  }
}

user.update_subnet(node_id, subnet_id, body)
const nodeID = '594e606212e17a002f2e3251';
const subnetID = '59c9f77cd412960028b99d2b';
const body = {
  "preferences": {
    "allow_foreign_transactions":true,
    "daily_atm_withdrawal_limit":10,
    "daily_transaction_limit":1000
  }
};

user.updateSubnet(nodeID, subnetID, body);
node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'
body= {
  "preferences": {
    "allow_foreign_transactions":true,
    "daily_atm_withdrawal_limit":10,
    "daily_transaction_limit":1000
  }
}

user.update_subnet(node_id: node_id, payload: body, subnter_id: subnet_id)
$preferences = (object)[
     "allow_foreign_transactions" => true,
     "daily_atm_withdrawal_limit" => 10,
     "daily_transaction_limit" => 1000
];
$body = (object)[
 "preferences" => $preferences
];

node_id = '594e606212e17a002f2e3251'
subnet_id = '59c9f77cd412960028b99d2b'

$user->update_subnet(node_id, subnet_id, $body);
nodeID := "594e606212e17a002f2e3251"
subnetID := "5bc920f2fff373002bf0d51b"
body := `{
  "preferences": {
    "allow_foreign_transactions":true,
    "daily_atm_withdrawal_limit":10,
    "daily_transaction_limit":1000
  }
}`

data, err := user.UpdateSubnet(nodeID, subnetID, body)

EXAMPLE RESPONSE

{
    "_id": "5bc920f2fff373002bf0d51b",
    "_links": {
        "self": {
            "href": "https://uat-api.synapsefi.com/v3.1/users/5bb29f48520da000a38cb107/nodes/5bb29f5471fd1b0091317410/subnets/5bc920f2fff373002bf0d51b"
        }
    },
    "access_token": "5bc920f9a5061e002681c89f",
    "account_class": "DEBIT_CARD",
    "card_hash": "78eb685b26d99d32538feb97cfd1274f994bdde48fa75471f22ba3029cbbc4e0",
    "card_number": "5431",
    "card_style_id": null,
    "client": {
        "id": "5b0da0f66e990e001f0c5f54",
        "name": "YY Test Account"
    },
    "cvc": "***",
    "exp": "2022-11-17",
    "nickname": "My Debit Card",
    "node_id": "5bb29f5471fd1b0091317410",
    "preferences": {
        "allow_foreign_transactions": true,
        "daily_atm_withdrawal_limit": 10,
        "daily_transaction_limit": 1000
    },
    "status": "ACTIVE",
    "user_id": "5bb29f48520da000a38cb107"
}

Update Card Preferences


Update the limits & preferences on the debit card

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.