Create Customer Payment

post

https://pg-sandbox.paymaya.com/payments/v1/customers/{customerId}/cards/{cardToken}/payments

Execute payment via a vaulted card of a customer.

For Basic Authentication, use SECRET API KEY. Learn more

Depending on the setting of the merchant, the payment may or may not require the following:

3DS verification
Card verification code (CVC) re-entry

If the merchant wishes to have the listed features enabled on all customer card payments, they should contact their Maya Relationship Manager.

The Create Customer Payment endpoint supports two specifications:

Kount Buyer - Use when Kount Fraud Protection is enabled. All fields tagged as required must be provided; others are optional.
Basic Buyer – Use when Kount is NOT enabled. All fields are optional, but at least one valid field must be provided.

Path Params

customerId

uuid

required

The unique identification string of a customer record.

cardToken

string

required

The string token representing the card information (only relevant for card-based payments).

Body Params

totalAmount

object

required

Contains the value and currency of the transaction.

redirectUrl

object

Contains a list of redirect URLs of the merchant for specific events.

requestReferenceNumber

string

length between 1 and 36

The merchant's reference number for the transaction. It is strongly advised that the merchant provide unique value for this property for each transaction.

authorizationType

string

enum

For card transactions, it indicates the type of authorization applied. For more information, click this link.

Allowed:

metadata

object

Used to provide additional data to the transaction such a payment faciliator information.

card

object

Card with CVC information. This is only required if the merchant is enabled to always require CVC entry on every customer payment.

Response

200Successfully created customer payment.