PApaymentology
Credit cards

Renew or replace a credit card in Lume and sync in PayCredit

Renews or replaces an existing credit card identified by its token. The request controls the card action, generated image/XML delivery, expiry date, reason, and remarks. The returned card details may be synchronized with PayCredit immediately or queued for synchronization.

post/card/renewal

Request

  • Base URL
    http://<host-url>
  • URL
    http://<host-url>/card/renewal
  • Auth
    HTTP bearer

Headers

unique-request-idstring

Unique identifier of a request.

Request body

card_actioninteger required

Card action: 1 - REPLACE, 2 - RENEW.

exp_datestring

Expiry date in format yyyy-MM-dd HH:mm:ss.

image_deliveryinteger required

How to deliver the card image and details: 1 - plain base64 image with encrypted pan, cvv, token, expiry, and emboss_name; 2 - encrypted image bytes with encrypted pan, cvv, token, expiry, and emboss_name; 3 - JSON data details without an image; 4 - encrypted image bytes with masked pan, cvv, token, expiry, and emboss_name.

image_namestring required

Image template name for the card to be generated.

reasonstring

Reason for renewing or replacing the card.

remarksstring

Remarks for the API request.

tokeninteger required

Token of the existing card to renew or replace.

user_idstring

Optional user identifier associated with the renewal or replacement request.

Response

Credit card renewed/replaced in BL, PC sync pending

3ds_enrollment_failure_reasonboolean
ac_idinteger
bill_act_amtnumber double
bill_blk_amtnumber double
bill_pnd_amtnumber double
cvvstring
emboss_namestring
epanstring
expirystring
image_base64string
is_3ds_enrolledboolean
last_four_digitstring
load_ccystring
mpanstring
tokeninteger

Changes

No recorded changes to this operation across all 1 revision of this API.