Welcome to the givecard api

Getting Started

GiveCard APIs

auth
- Test Authget
cardLoadsTransfers
bankTransfers
orderCards
simulate
fundingAccount
reporting
merchantRulesDeprecated
superbusiness
- Create Programpost
- Get Programsget
webhooks
manageCard
spendRules

Welcome to the givecard api

Getting Started

GiveCard APIs

auth
- Test Authget
cardLoadsTransfers
bankTransfers
orderCards
simulate
fundingAccount
reporting
merchantRulesDeprecated
superbusiness
- Create Programpost
- Get Programsget
webhooks
manageCard
spendRules

Create Merchant Rule (decommissioned)

post https://api.dev.givecard.dev/api/v1/business/merchantRule

This endpoint is no longer supported. Please use CreateSpendRule instead.
Creates a merchant category spend rule that allows or blocks specified merchant categories.
The mode can be set to 'block' to prevent spending at listed merchant categories, or 'allow' to restrict spending to only merchants within the list.
For a complete list of merchant categories, refer to the Getting Started section of the docs.

URL Expired

The URL for this request expired after 30 days.

Query Params

programId

string

Program ID is only required for superbusinesses. Only cards within the program can have this spend rule applied.

Body Params

merchantCategories

array of strings

required

merchantCategories*

mode

string

required

allow MerchantRuleModeAllow In 'allow' mode, only transactions within specified merchant categories are permitted; transactions at unlisted merchant category will be declined.
block MerchantRuleModeBlock In 'block' mode, spending at merchants within selected categories is prohibited; transactions at any listed merchant category will be blocked."

name

string

required

Responses

Response body

object

merchantRule

object

businessId

uuid

The ID of the business associated with the merchant rule. Only cards within this business can have the merchant rule applied.

createdAt

date-time

The time the merchant rule was created in UTC.

uuid

The merchant rule's primary identifier.

merchantCategories

array of strings

The array of merchant categories encompassed by an mcc based merchant rule. To see the full list of merchant categories GiveCard can restrict, refer to "Spend Rules".

merchantCategories

mode

string

allow block

name

string

A descriptive name for the merchant rule, created by the business.

scope

string

The level of the merchant rule. The scope determines the level at which the merchant rule is applied. The scope can be "card", "program", or "super".
card MerchantRuleScopeCard Merchant Rule Scope
program MerchantRuleScopeProgram
super MerchantRuleScopeSuper

card program super

updatedAt

date-time

The time of the most recent update to the merchant rule in UTC.

Response body

object

badRequest

object

Describes violations in a client request. This error type focuses on the
syntactic aspects of the request.

fieldViolations

array of objects

Describes all violations in a client request.

fieldViolations

object

description

string

A description of why the request element is bad.

field

string

A path leading to a field in the request body. The value will be a
sequence of dot-separated identifiers that identify a mesasge field.
E.g., "fieldViolations.field" would identify this field.

code

int64

errorInfo

object

Metadata

object

Has additional fields

Reason

string

The reason of the error. This is a constant value that identifies the
proximate cause of the error.
This should be at most 63 characters and match /[A-Z0-9_]+/.
UNKNOWN ReasonUnknown
OUTDATED_VERSION ReasonOutdatedVersion

UNKNOWN OUTDATED_VERSION

fieldErrors

object

Has additional fields

localizedMessage

object

Provides a localized error message that is safe to return to the user
which can be attached to an RPC error.

locale

string

The locale used following the specification defined at
http://www.rfc-editor.org/rfc/bcp/bcp47.txt.
Examples are: "en-US", "fr-CH", "es-MX"

message

string

The localized error message in the above locale.

msg

string

required

requestInfo

object

Contains metadata about the request that clients can attach when filing a bug
or providing other forms of feedback.

requestID

string

An opaque string that should only be interpreted by the service generating
it. For example, it can be used to identify requests in the service's logs.

servingData

string

Any data that was used to serve this request. For example, an encrypted
stack trace that can be sent back to the service provider for debugging.

Response body

object

badRequest

object

Describes violations in a client request. This error type focuses on the
syntactic aspects of the request.

fieldViolations

array of objects

Describes all violations in a client request.

fieldViolations

object

description

string

A description of why the request element is bad.

field

string

A path leading to a field in the request body. The value will be a
sequence of dot-separated identifiers that identify a mesasge field.
E.g., "fieldViolations.field" would identify this field.

code

int64

errorInfo

object

Metadata

object

Has additional fields

Reason

string

UNKNOWN OUTDATED_VERSION

fieldErrors

object

Has additional fields

localizedMessage

object

Provides a localized error message that is safe to return to the user
which can be attached to an RPC error.

locale

string

The locale used following the specification defined at
http://www.rfc-editor.org/rfc/bcp/bcp47.txt.
Examples are: "en-US", "fr-CH", "es-MX"

message

string

The localized error message in the above locale.

msg

string

required

requestInfo

object

Contains metadata about the request that clients can attach when filing a bug
or providing other forms of feedback.

requestID

string

An opaque string that should only be interpreted by the service generating
it. For example, it can be used to identify requests in the service's logs.

servingData

string

Any data that was used to serve this request. For example, an encrypted
stack trace that can be sent back to the service provider for debugging.

Response body

object

badRequest

object

Describes violations in a client request. This error type focuses on the
syntactic aspects of the request.

fieldViolations

array of objects

Describes all violations in a client request.

fieldViolations

object

description

string

A description of why the request element is bad.

field

string

A path leading to a field in the request body. The value will be a
sequence of dot-separated identifiers that identify a mesasge field.
E.g., "fieldViolations.field" would identify this field.

code

int64

errorInfo

object

Metadata

object

Has additional fields

Reason

string

UNKNOWN OUTDATED_VERSION

fieldErrors

object

Has additional fields

localizedMessage

object

Provides a localized error message that is safe to return to the user
which can be attached to an RPC error.

locale

string

The locale used following the specification defined at
http://www.rfc-editor.org/rfc/bcp/bcp47.txt.
Examples are: "en-US", "fr-CH", "es-MX"

message

string

The localized error message in the above locale.

msg

string

required

requestInfo

object

Contains metadata about the request that clients can attach when filing a bug
or providing other forms of feedback.

requestID

string

An opaque string that should only be interpreted by the service generating
it. For example, it can be used to identify requests in the service's logs.

servingData

string

Any data that was used to serve this request. For example, an encrypted
stack trace that can be sent back to the service provider for debugging.

Updated about 1 month ago

Get Cards

Get Business Merchant Rules

Did this page help you?

Language

Credentials

Header


xxxxxxxxxx
1
curl --request POST \
2
     --url https://api.dev.givecard.dev/api/v1/business/merchantRule \
3
     --header 'accept: */*' \
4
     --header 'content-type: application/json' \
5
     --data '{"mode":"allow"}'

Click Try It! to start a request and see the response here! Or choose an example:

*/*

Updated about 1 month ago

Get Cards

Get Business Merchant Rules

Did this page help you?

Welcome to the givecard api
Getting Started
FAQs
GiveCard Transfers: RTP, FedNow, ACH
Webhooks
Spend Rules
MerchantCategories
Greenlighting and Redlighting
Velocity Spend Rules
Merchant Spend Rules
SuperBusinesses and ProgramIds
Idempotency
Authentication
Quickstart

GiveCard APIs
auth
Test Authget
cardLoadsTransfers
Withdraw Funds From Cardpost
Load Cardspost
Card To Card Transferpost
Delete Cards From Autoloaddelete
Add Cards To Autoloadpost
Modify Autoload Profilepatch
Get Autoload Profileget
Get Business Autoload Profilesget
Create Autoload Profilepost
bankTransfers
Get Bank Transferget
Initiate Bank Transferpost
Get Bank Transfersget
Get Bank Transfers for Recipientget
Add Bank Account to Recipientpost
Get Bank Transfer Recipientget
Get Bank Transfer Recipientsget
Update Recipientpatch
Create Bank Transfer Recipientpost
Delete Bank Accountdelete
orderCards
Order And Ship Cardspost
Issue Virtual Card And Generate Linkpost
Issue Virtual Cardspost
Issue a Single Card Synchronouslypost
Get Individual Card Orderget
Get Business Card Ordersget
simulate
Simulate Transactionpost
Simulate Funding Account Depositpost
Simulate Card Order Shippedpost
fundingAccount
Get Funding Accountsget
Get Funding Account Depositsget
Transfer Between Funding Accountspost
Get Funding Account Balanceget
reporting
Get Cardsget
Get Business Transactionsget
Get Business Card Load Historyget
merchantRulesDeprecated
Add Merchant Rule To Cardpost
Remove Merchant Rule From Carddelete
Modify Merchant Rule (decommissioned)patch
Get Merchant Ruleget
Get Business Merchant Rulesget
Create Merchant Rule (decommissioned)post
superbusiness
Get Programsget
Create Programpost
webhooks
Get Webhook Endpoint Secretget
Create Webhook Endpointpost
Get Webhook Endpointsget
Get Webhook Portal Access Linkget
manageCard
Unlock Cardpost
Unfreeze Cardpost
Get Card Transactionsget
Delete Tag from Carddelete
Reissue Virtual Cardpost
Reissue And Ship Physical Cardpost
Reassociate Cardpost
Set Card Pinpost
Lock Cardpost
Get Card Load Historyget
Freeze Cardpost
Get Card Detailsget
Close Cardpost
Generate Card Client Tokenpost
Get Card Balanceget
Add Tag To Cardspost
spendRules
Remove Spend Rule From Card(s)delete
Add Spend Rule To Card(s)post
Update Spend Rulepatch
Delete Spend Ruledelete
Create Spend Rulepost
Get Spend Rulesget
Get Spend Rules On Cardget

Welcome to the givecard api
Getting Started
FAQs
GiveCard Transfers: RTP, FedNow, ACH
Webhooks
Spend Rules
MerchantCategories
Greenlighting and Redlighting
Velocity Spend Rules
Merchant Spend Rules
SuperBusinesses and ProgramIds
Idempotency
Authentication
Quickstart

GiveCard APIs
auth
Test Authget
cardLoadsTransfers
Withdraw Funds From Cardpost
Load Cardspost
Card To Card Transferpost
Delete Cards From Autoloaddelete
Add Cards To Autoloadpost
Modify Autoload Profilepatch
Get Autoload Profileget
Get Business Autoload Profilesget
Create Autoload Profilepost
bankTransfers
Get Bank Transferget
Initiate Bank Transferpost
Get Bank Transfersget
Get Bank Transfers for Recipientget
Add Bank Account to Recipientpost
Get Bank Transfer Recipientget
Get Bank Transfer Recipientsget
Update Recipientpatch
Create Bank Transfer Recipientpost
Delete Bank Accountdelete
orderCards
Order And Ship Cardspost
Issue Virtual Card And Generate Linkpost
Issue Virtual Cardspost
Issue a Single Card Synchronouslypost
Get Individual Card Orderget
Get Business Card Ordersget
simulate
Simulate Transactionpost
Simulate Funding Account Depositpost
Simulate Card Order Shippedpost
fundingAccount
Get Funding Accountsget
Get Funding Account Depositsget
Transfer Between Funding Accountspost
Get Funding Account Balanceget
reporting
Get Cardsget
Get Business Transactionsget
Get Business Card Load Historyget
merchantRulesDeprecated
Add Merchant Rule To Cardpost
Remove Merchant Rule From Carddelete
Modify Merchant Rule (decommissioned)patch
Get Merchant Ruleget
Get Business Merchant Rulesget
Create Merchant Rule (decommissioned)post
superbusiness
Get Programsget
Create Programpost
webhooks
Get Webhook Endpoint Secretget
Create Webhook Endpointpost
Get Webhook Endpointsget
Get Webhook Portal Access Linkget
manageCard
Unlock Cardpost
Unfreeze Cardpost
Get Card Transactionsget
Delete Tag from Carddelete
Reissue Virtual Cardpost
Reissue And Ship Physical Cardpost
Reassociate Cardpost
Set Card Pinpost
Lock Cardpost
Get Card Load Historyget
Freeze Cardpost
Get Card Detailsget
Close Cardpost
Generate Card Client Tokenpost
Get Card Balanceget
Add Tag To Cardspost
spendRules
Remove Spend Rule From Card(s)delete
Add Spend Rule To Card(s)post
Update Spend Rulepatch
Delete Spend Ruledelete
Create Spend Rulepost
Get Spend Rulesget
Get Spend Rules On Cardget

200

400

404

500