Credit Card

Zūm Rails offers card payment methods designed for ease and efficiency. For example, credit card's can be used for accounts receivable transactions to request funds.

Method: POST

Endpoint: {{env}}/api/transaction

Example

Request Payload

{
  "ZumRailsType": "AccountsReceivable",
  "TransactionMethod": "CreditCard",
  "Amount": 123.45,
  "Memo": "Memo",
  "Comment": "This transaction is just a test from a user to wallet",
  "UserId": "1d431e8b-...85452adb4eee",
  "Authorize": {
    "Capture": false,
    "AutoExpireDays": 5
  }
}

Refund a Transaction

With Zūm Rails, it is easy to refund Credit Card transactions. Currently we support whole/partial refunds of initial transactions. When you create a new refund, you must specify the transaction ID that you wish to refund. Creating a new refund will refund a transaction that has previously been created but not yet refunded. Funds will be refunded to the credit card that was originally charged.

Method: POST

Endpoint: {{env}}/api/transaction/{transaction_id}/refund

Chargeback

Chargeback applies only for credit card transactions and it can be accepted or disputed by the user until the due date. After the chargeback due date passes, the chargeback is accepted by default.

Accept Chargeback

Use this endpoint to accept a specific chargeback for a credit card transaction.

Method: PATCH

Endpoint: {{env}}/api/TransactionChargeback/{{TransactionChargebackId}}/accept

Dispute Chargeback

Use this endpoint to dispute a specific chargeback for a credit card transaction.

Method: PATCH

Endpoint: {{env}}/api/TransactionChargeback/{{TransactionChargebackId}}/dispute

Note:

• A chargeback cannot be disputed if it is already accepted or disputed or is past due date.

Processing Schedule

Credit Card - Bambora

• Transactions are sent when they are created;

• Responses are received right away;

Credit Card - Authorize.net

• Transactions are sent when they are created;

• Responses are received right away;

Transaction Limits

Transaction Limit	Minimum	Maximum
Amount limit per transaction	$0.00	Unlimited
Maximum volume per day	$0.00	Unlimited
Transaction per day	$0.00	$99,999,999
Maximum Volume Per Month	$0.00	Unlimited

Transaction Events

CreditCard	CreditCardInvalidRequest	When transaction has failed due to invalid request
CreditCard	CreditCardRejectedByIssuingBank	When transaction is rejected by issuing bank
CreditCard	CreditCardExpiredCard	When transaction has failed due to expired card
CreditCard	CreditCardSuspectedFraud	When transaction has failed due to suspected fraud
CreditCard	CreditCardTransactionNotPermitted	When transaction is not permitted
CreditCard	CreditCardContactSupport	When transaction has failed. Contact support
CreditCard	CreditCardInvalidMerchantSetUp	When transaction has failed due to invalid merchant setup
CreditCard	CreditCardSecurityViolation	When transaction has failed due to security violation
CreditCard	CreditCardInvalidCardOrDetails	When transaction has failed due to invalid card or card details
CreditCard	CreditCardLostOrStolenCard	When transaction has failed due to lost ot stolen card
CreditCard	CreditCardAccountClosedOrBlocked	When transaction has failed due to account closed or blocked
CreditCard	CreditCardDeemedHighRisk	When transaction has failed due to deemed high risk
CreditCard	CreditCardUnknownResponseFromIssuingBank	When transaction has failed due to unknown response from issuing bank
CreditCard	CreditCardCouldNotLocateOriginalTransaction	When reversal transaction has failed due to could not locate original transaction
CreditCard	CreditCardTransactionAlreadyReversed	When reversal transaction has failed due to already reversed
CreditCard	CreditCardGenericError	When transaction has failed due to generic error
CreditCard	CreditCardServiceUnavailable	When transaction has failed due to service unavailable
CreditCard	CreditCardRetryLater	When transaction has failed. Retry later
CreditCard	CreditCardReversalRejected	When reversal transaction is rejected
CreditCard	CreditCardDuplicateReversal	When reversal transaction has failed due to duplicated
CreditCard	CreditCardTransactionAlreadySettled	When reversal transaction has failed due to already settled
CreditCard	CreditCardTimeoutReversal	When reversal transaction has failed due to timeout
CreditCard	CreditCardDuplicateTransaction	When transaction has failed due to duplicated

Testing

To simulate an Credit Card transaction failure, include an event name from the list above in the COMMENT field when creating a transaction. If you don't mention an event in the COMMENT, the transaction will change its status to "Completed" in the sandbox environment.

Examples:

Simulating success

{
  "ZumRailsType": "AccountsReceivable",
  "TransactionMethod": "CreditCard",
  "Amount": 123.45,
  "Memo": "Memo",
  "Comment": "This transaction will succeed because there's no keyword",
  "UserId": "1d431e8b-...85452adb4eee",
  "WalletId": "8ebd932b-...b92633e14297",
  "PaymentInstrumentId": "92142401-...389ba0d87e75"
}

Simulating Failure

{
  "TransactionMethod": "CreditCard",
  "Amount": 123.45,
  "Memo": "Memo",
  "Comment": "CreditCardExpiredCard",
  "UserId": "1d431e8b-...85452adb4eee",
  "WalletId": "8ebd932b-...b92633e14297",
  "PaymentInstrumentId": "92142401-...389ba0d87e75"
}