Update a project contract
Merges the fields you send into the contract of the project, and creates the contract when it doesn't exist.
The fields depend on the contract type. For silverflow-v2 and silverflow-oct with a boarding_mode other
than disabled, Ginger boards the merchant at Silverflow after the contract is saved, see
Silverflow merchant boarding.
apiKeyAuthorizationBasic <token>HTTP Basic authentication with an admin API key as the username and an empty password.
merchant_id*stringThe ID of the merchant.
uuidproject_id*stringThe ID of the project.
uuidcontract*stringThe contract type: silverflow-v2, silverflow-oct, ginger-elavon, rapyd, shift4, credit-card,
amex, google-pay, apple-pay, bancontact, vipps-mobilepay or swish. See
Processor contracts.
application/json- body
Visa, Mastercard and Bancontact through Silverflow. With boarding_mode disabled, give the acceptor_key
per scheme. With acceptors-only (needs merchant_key) or full-merchant, give the bin_key and mid per
scheme, and Ginger boards the merchant at Silverflow. See
Silverflow merchant boarding.
begin_date?stringStart date of the contract (ISO 8601).
end_date?|End date of the contract (ISO 8601).
funding_delay?integerDays to wait with funding after a sale or capture.
manual_capture_enabled?booleanAllow manual capture. See Capture modes.
delayed_capture_enabled?booleanAllow delayed capture.
boarding_mode*string"disabled""acceptors-only""full-merchant"merchant_key?stringThe Silverflow merchant key. Required for acceptors-only.
currencies?array<string>ISO 4217 currency codes the contract accepts.
dynamic_3ds_rules?array<>Dynamic 3DS rules, evaluated top to bottom. The first enabled rule whose conditions all match decides. See Dynamic 3-D Secure rules.
schemes*The fields of the contract.
application/json- response
Visa, Mastercard and Bancontact through Silverflow. With boarding_mode disabled, give the acceptor_key
per scheme. With acceptors-only (needs merchant_key) or full-merchant, give the bin_key and mid per
scheme, and Ginger boards the merchant at Silverflow. See
Silverflow merchant boarding.
begin_date?stringStart date of the contract (ISO 8601).
end_date?|End date of the contract (ISO 8601).
funding_delay?integerDays to wait with funding after a sale or capture.
manual_capture_enabled?booleanAllow manual capture. See Capture modes.
delayed_capture_enabled?booleanAllow delayed capture.
boarding_mode*string"disabled""acceptors-only""full-merchant"boarding_status?stringThe result of automatic boarding, or the field to fix.
merchant_key?stringThe Silverflow merchant key. Required for acceptors-only.
currencies?array<string>ISO 4217 currency codes the contract accepts.
dynamic_3ds_rules?array<>Dynamic 3DS rules, evaluated top to bottom. The first enabled rule whose conditions all match decides. See Dynamic 3-D Secure rules.
schemes*curl -X PUT 'https://api.example.com/v1/admin/merchants/497f6eca-6276-4993-bfeb-53cbbbba6f08/projects/497f6eca-6276-4993-bfeb-53cbbbba6f08/contracts/string/' \ --user "$API_KEY:" \ -H 'Content-Type: application/json' \ -d '{ "boarding_mode": "full-merchant", "currencies": [ "EUR" ], "schemes": { "visa": { "charge_type": "charge", "bin_key": "bin-visa-123", "mid": "MID-VISA-456" }, "mastercard": { "charge_type": "charge", "bin_key": "bin-mc-789", "mid": "MID-MC-012" } }}'{ "boarding_mode": "disabled", "boarding_status": "string", "merchant_key": "string", "currencies": [ "EUR", "USD" ], "dynamic_3ds_rules": [ { "name": "string", "conditions": [ { "field": "card_issuing_country", "operator": "in", "value": [ "st" ] } ], "action": { "request_3ds": "always" }, "enabled": true } ], "schemes": { "visa": { "charge_type": "charge", "acceptor_key": "string", "bin_key": "string", "mid": "string", "boarding_status": "string", "scheme_transaction_type": "string", "funding_type": "string", "sender_is_receiver": false, "receiver_first_name": "string", "receiver_last_name": "string", "receiver_account_number": "string", "receiver_account_number_type": "card-account", "purpose_of_payment": "string" }, "mastercard": { "charge_type": "charge", "acceptor_key": "string", "bin_key": "string", "mid": "string", "boarding_status": "string", "scheme_transaction_type": "string", "funding_type": "string", "sender_is_receiver": false, "receiver_first_name": "string", "receiver_last_name": "string", "receiver_account_number": "string", "receiver_account_number_type": "card-account", "purpose_of_payment": "string" }, "bancontact": { "charge_type": "charge", "acceptor_key": "string", "bin_key": "string", "mid": "string", "boarding_status": "string", "scheme_transaction_type": "string", "funding_type": "string", "sender_is_receiver": false, "receiver_first_name": "string", "receiver_last_name": "string", "receiver_account_number": "string", "receiver_account_number_type": "card-account", "purpose_of_payment": "string" } }, "begin_date": "2026-11-01", "end_date": "string", "funding_delay": 0, "manual_capture_enabled": true, "delayed_capture_enabled": true}