B2B Wallet Management - PINS, Passcodes, and Passwords

resetCustomerPasscode

Changes the value of the passcode property (PIN) associated with the wallet login profile.

PUT URL/b2b-gateway/customers/security/passcode

The recovery code is generated using retrieveRecoveryCode.

Request

Attribute Description
b2bRequest Required B2bRequest
Identifies the request to the B2B Gateway.
customerUri Required String
The unique identifier of a registered mobile wallet user.
issuingPartnerUri RequiredString
The unique identifier of the Paydiant partner that issued the mobile payments app.
partnerUri Required String
The unique identifier of the Paydiant partner under which the issuer is registered.
recoveryCode Required String
The unique reset authorization code obtained in the retrieveRecoveryCode response.
newPasscode Required String
The value to which the property will be updated.

Response

Attribute Description
b2bResponse Required B2bResponse
Identifies the response from the B2B Gateway.

resetCustomerPassword

Changes the value of the password property associated with the wallet login profile.

PUT URL/b2b-gateway/customers/security/password

The Recovery Code is generated using retrieveRecoveryCode.

Request

Attribute Description
b2bRequest Required B2bRequest
Identifies the request to the B2B Gateway.
customerUri Required String
The unique identifier of a registered mobile wallet user.
issuingPartnerUri Required String
The unique identifier of the Paydiant partner that issued the mobile payments app.
partnerUri Required String
The unique identifier of the Paydiant partner under which the issuer is registered.
recoveryCode Required String
The unique reset authorization code obtained in the retrieveRecoveryCode response.
newPassword Required String
The value to which the Password will be updated.

Response

Attribute Description
b2bResponse Required B2bResponse
Identifies the response from the B2B Gateway.

retrieveCustomerCredentialsSpecification

Used to define the specific parameters considered valid when setting or resetting passwords and passcodes.

POST URL/b2b-gateway/partners/credentialspecification/search

This API enables Issuing Partners to control their password/passcode credential security rules.

The credential parameters are set when the Issuing Partner is onboarded.

Request

Attribute Description
b2bRequest Required B2bRequest
Identifies the request to the B2B Gateway.
issuingPartnerUri Required String
The unique identifier of the Paydiant partner that issued the mobile payments app where the wallet is registered.
partnerUri Required String
The unique identifier of the Paydiant partner under which the issuer is registered.

Response

Attribute Description
b2bResponse Required B2bResponse
Identifies the response from the B2B Gateway.
passcodeValdiationEnabled Required Boolean
Determines whether validation should be performed on the passcode value as it is entered into the form in the app.
TRUE - Validate on entry
FALSE - Do not validate on entry
passcodeLength Required Integer
The exact number of digits equired for the passcode value. 10 char.
passcodeProhibitedValues Optional String
Indicates any values that cannot be used for any passcode.
passcodeAllowSameValuesBoolean Required Boolean
Specifies whether the passcode may contain identical sequential digits, such as 7788.
TRUE - Identical sequential passcode digits are allowed.
FALSE - Passcode digits cannot be identical or sequential.
passcodeAllowIncrementalValues Required Boolean
Specifies whether the passcode may contain sequential digits that are in order, such as 1234.
TRUE - Sequential passcode digits in numerical order are allowed.
FALSE - Sequential passcode digits cannot be in order.
passcodeNumericOnly Required Boolean
Specifies whether the passcode is required to contain only numerical digits, with no letters or symbols.
TRUE - Passcode cannot contain alpha characters.
FALSE - Passcode can use numeric or alphabetic characters.
passcodeRegularExpression Required String
The set of characters (in regular expression format) that represents the complete list of characters that are supported in the passcode and against which new passcode settings will be validated. If a user inputs a proposed passcode that contains characters not represented here, the passcode will be rejected as invalid.
passwordMinLength Required Integer
Represents the fewest number of characters permitted for a valid password value. The default value is 6. 10 char.
passwordMaxLength Required Integer
Represents the maximum number of characters permitted for a valid password value. The default value is 12. 10 char.
passwordLowercaseRequired Required String
Indicates if the password value must contain at least one lower case character. The default value is FALSE.
TRUE - The password must have a lowercase character.
FALSE - The password does not require lowercase.
passwordUppercaseRequired Required Boolean
Indicates if the password value must contain at least one upper case character. The default value is FALSE.
TRUE - the password must have an uppercase character.
FALSE - The password does not require uppercase.
passwordNumeralRequired Required Boolean
Specifies whether the password value must contain at least one numeral.The default value is FALSE.
TRUE - The password must have a numeric character.
FALSE - The password does not require a numeric character.
passwordAlphaRequired Required Boolean
Indicates if the password value must contain at least one alphabetic character.
TRUE - The password must have an alphabetic character.
FALSE - The password does not require an alphabetic character.
passwordRegularExpression Required String
The set of characters (in regular expression format) that represents the complete list of characters that are supported in the password and against which new password settings will be validated. If a user inputs a proposed password that contains characters not represented here, the password will be rejected as invalid. A sample value is: a-zA-Z0-9~!@#$%^&*()-{}

updateCustomerPIN

Used to change PIN for a customer.

POST URL/b2b-gateway/customers/security/passcode/update

Request

Attribute Description
b2bRequest Required B2bRequest
Identifies the request to the B2B Gateway.
issuingPartnerUri Required String
The unique identifier of the Paydiant partner that issued the mobile payments app where the wallet is registered.
partnerUri Required String
The unique identifier of the Paydiant partner under which the issuer is registered.
customerUri Required String
The unique identifier of a registered mobile wallet user.
oldPin Required String
The existing PIN for this customer
newPin Required String
The new PIN to use for this customer.

Response

Attribute Description
b2bResponse Required B2bResponse
Identifies the response from the B2B Gateway.

updateCustomerSecurityInfo

Used to change password, passcode, PIN, or security questions for a customer.

POST URL/b2b-gateway/customers/security/update

Request

Attribute Description
b2bRequest Required B2bRequest
Identifies the request to the B2B Gateway.
issuingPartnerUri Required String
The unique identifier of the Paydiant partner that issued the mobile payments app where the wallet is registered.
partnerUri Required String
The unique identifier of the Paydiant partner under which the issuer is registered.
customerUri Required String
The unique identifier of a registered mobile wallet user.
oldPassword Required String
The existing password for the customer.
newPassword Required String
The new password for this customer.
oldPin Required String
newPin Required String
The new PIN to use for this customer.
questionsAnswers Optional Object
The list of QuestionAnswer objects used to verify that the correct customer is accessed.

Response

Attribute Description
b2bResponse Required B2bResponse
Identifies the response from the B2B Gateway.

updateExpiredCustomerPassword

Changes an expired password for a customer login account.

PUT URL/b2b-gateway/customers/security/expiredpassword

Request

Attribute Description
b2bRequest Required B2bRequest
Identifies the request to the B2B Gateway.
customerUri Required String
The unique identifier of a registered mobile wallet user.
issuingPartnerUri Required String
The unique identifier of the Paydiant partner that issued the mobile payments app where the wallet is registered.
partnerUri Required String
The unique identifier of the Paydiant partner under which the issuer is registered.
oldPassword Required String
The currently used password for this user.
newPassword Required String
The new password to use for this user.
recoveryCode Required String
An authorization string generated by the B2B service for the purpose of validating a login credential reset request for a particular wallet.

Response

Attribute Description
b2bResponse Required B2bResponse
Identifies the response from the B2B Gateway.
Feedback