Cards

Activate Card

Use this endpoint to set the users current prepaid card status to Activated.

Method: PATCH

Endpoint: {{env}}/api/card/activate-card/{{userId}}

{
    "UserId": "8ebd932b-...b92633e14297",
    "CardProgramId": "Customer_Card_Program"
}

Input Parameters

Parameter
Type
Mandatory
Description

UserId

Guid

Yes

User Id

CardProgramId

String

Yes

Card Program Id (Case Sensitive)

Response

Parameter
Type
Description

ResponseDesc

String

Description of the response

ZumEvent

String

Zum event

Change Card Program

Use this endpoint to change the card program of the current card attached to the user.

Method: PATCH

Endpoint: {{env}}/api/card/change-card-program

{
    "UserId": "8ebd932b-...b92633e14297",
    "NewProgramId": "Customer_Card_Program"
}

Input Parameters

Parameter
Type
Mandatory
Description

UserId

Guid

Yes

User Id

NewProgramId

String

Yes

New Card Program Id (Case Sensitive)

Response

Parameter
Type
Description

CardReferenceId

String

Card Reference Id

NewProgramId

String

New Card Program Id

ResponseDesc

String

Response description

ZumEvent

String

Zum event

Get Balance Inquiry

Use this endpoint to get the balance on the current card attached to the user.

Method: GET

Endpoint: {{env}}/api/card/balance-inquiry/{{userId}}

{
    "statusCode": 200,
    "message": "GET Request successful.",
    "isError": false,
    "result": {
        "ResponseDesc": "Operation is successful.",
        "AvailableBalance": 100,
        "LedgerBalance": 0,
        "ZumEvent": "ZumCardSuccess"
    }
}

Response

Parameter
Type
Description

ResponseDesc

String

Response description

AvailableBalance

Number

Current balance of the card

LedgerBalance

String

Ledger balance of the card

ZumEvent

String

Zum event

Get Card Accounts

Use this endpoint to gather all the cards attached to this user.

Method: GET

Endpoint: {{env}}/api/card/get-card-accounts/{{userId}}

{
    "statusCode": 200,
    "message": "GET Request successful.",
    "isError": false,
    "result": {
        "ResponseDesc": "Operation is successful.",
        "AvailableBalance": 0.0,
        "LastDepositAmount": 0.0,
        "LedgerBalance": 0.0,
        "ZumEvent": "ZumCardSuccess",
        "Cards": [
            {
                "CardNumber": "************2208",
                "IsRegistered": "N",
                "CardReferenceId": "110195650227752",
                "CardProgramId": "Zumrail_test_prog",
                "Status": "Activated",
                "CustomerId": "110000001956502277"
            }
        ]
    }
}

Input Parameters

Parameter
Type
Mandatory
Description

UserId

Guid

Yes

User Id

Response

Parameter
Type
Description

ResponseDesc

String

Response description

AvailableBalance

Number

Current balance of the card

LastDepositAmount

String

Amount of last deposit

LedgerBalance

String

Ledger balance of the card

ZumEvent

String

Zum event

Cards

CardNumber

String

Card number

IsRegistered

Char (Y/N)

Card Registration Status

CardReferenceId

String

Card Reference Id

CardProgramId

String

Card Program Id

Status

String

Card Status

CardNumber

String

Card number

Get Card Status

Use this endpoint to get the card status of the user's current card.

Method: GET

Endpoint: {{env}}/api/card/get-card-status/{{userId}}

{
    "statusCode": 200,
    "message": "GET Request successful.",
    "isError": false,
    "result": {
        "CardStatus": "IssuedInactive",
        "ZumEvent": "ZumCardSuccess",
        "ResponseDesc": "Operation is successful."
    }
}

Input Parameters

Parameter
Type
Mandatory
Description

UserId

guid

Yes

User Id

Response

Parameter
Type
Description

CardStatus

String

Card Status

ZumEvent

String

Zum event

ResponseDesc

String

Response description

Set Card Status

Use this endpoint to set the card status of the user’s current card.

Method: POST

Endpoint: {{env}}/api/card/set-card-status

{
    "UserId": "8ebd932b-...b92633e14297",
    "CardStatus": "FraudBlock"
}

Request Parameters

Parameter
Type
Required
Description

UserId

Guid

Yes

User Id

CardStatus

String

Yes

New Card Status

Response

Parameter
Type
Description

CardStatus

String

Card Status

ZumEvent

String

Zum event

ResponseDesc

String

Response description

Card Status

These are the available card status updates.

Status
Description

Activated

Card is active and ready for use.

Closed

Card account is closed.

Inactive

Card is temporarily inactive.

FraudBlock

Card is blocked due to suspected fraud.

Reissue Card

Use this endpoint to reissue an existing non-closed card and close the existing card attached to the user.

Method: POST

Endpoint: {{env}}/api/card/reissue-card

{
    "UserId": "8ebd932b-...b92633e14297",
    "cardReferenceId": "110195650252149"
}

Request Parameters

Parameter
Type
Required
Description

UserId

Guid

Yes

User Id

CardReferenceId

String

Yes

Card Reference Id

Response

NewCardReferenceId

String

New Card Reference Id

ZumEvent

String

Zum event

ResponseDesc

String

Response description

UserId

Guide

User Id of the prepaid card user

Last4Digits

Number

Last 4 digits of the prepaid card number

ExpireMonth

Number

Expiry month of the prepaid card number

ExpireYear

Number

Expiry year of the prepaid card number

Available balance

Number

Available balance of the prepaid card number

Ledger Balance

Number

Ledger balance of the prepaid card number

FirstName

String

First name of the prepaid card user

LastName

String

Last name of the prepaid card user

CardStatus

String

Card status of the reissued card

CardProgramId

String

Card program the reissued card is assigned under

Email

String

Email address of the prepaid card user

Get Card Transactions

Use this endpoint for transaction history from a users prepaid card.

Method: POST

Endpoint: {{env}}/api/card/get-card-transactions

{
    "UserId": "8ebd932b-...b92633e14297",
    "CardReferenceId": "599000027458",
    "CreatedAtOperator": "isInTheLast",
    "CreatedAt": "2023-01-01 12:00:00.000",
    "Pagination": {
        "PageNumber": 1,
        "ItemsPerPage": 10
    }
}

Request Parameters

UserId

Guid

Yes

User Id

CardReferenceId

String

Yes

Card reference id

CardTransactionType

String

No

Card issuer transaction type

CardTransactionStatuses

String

No

Card transaction statuses

TransactionZumRailsType

String

No

Transaction zum rails type

CardTransactionId

String

No

Card issuer transaction id

GenericSearch

String

No

Filter the search with this text

AmountLowerLimit

Number

No

Lower limit transaction amount

AmountUpperLimit

Number

No

Upper limit transaction amount

CreatedAtOperator

String

No

Date filter type for query

CreatedAtFrom

Datetime

No

Start date for query

CreatedAtTo

Datetime

No

End date for query

CreatedAt

Datetime

No

Base date for query

Timezone

Windows or IANA

No

Timezone identifier

Pagination

-

Yes

PageNumber

Number

Yes

The respective page, starting at 1

ItemsPerPage

Number

Yes

The amount of items per page between 0 and 50

Response

CurrentPage

Number

Current page of transaction list

PageSize

Number

Number of items in page requested

TotalCount

Number

Number of total items queryable

Items

Id

Guid

Zum Rails Transaction Id

CreatedAt

Datetime

Created at date and time

SettlementDate

Date

Date funds settled

TransactionId

String

Card issuer transaction id

Description

String

Description of transaction

Status

String

Status of transaction

Debit

Number

Amount Debited

Credit

Number

Amount Credited

MerchantNameAndLocation

Number

Merchant name and location

CreatedAtOperator:

IsInTheLast

Between user creation date and now

ExactlyMatches

Exactly matches CreatedAt

IsBetween

Is between CreatedAtFrom and CreatedAtTo

IsAfter

Is after CreatedAt

IsOnOrAfter

Is on or after CreatedAt

IsBefore

Is before CreatedAt

IsBeforeOrOn

Is before or on CreatedAt

CardTransactionStatuses:

Posted

Posted transactions

Pending

Pre Auth Transactions

Declined

Declined Transcations

CardTransactionType:

POS

POS Purchase

ATM

Cash Withdrawal

Debit

Debit Transactions

Credit

Credit Transactions

Last updated

Was this helpful?