Add Stored Payment Method

Adds a new stored payment method to an existing payer profile. This call allows businesses to expand the payment options available to a payer, facilitating future transactions by storing necessary payment details securely.

Path parameters

payerIdstringRequired

The unique identifier for the payer.

Request

This endpoint expects an object.

Card Payment MethodobjectRequired

Mobile Money Payment MethodobjectRequired

Pay by Bank Payment MethodobjectRequired

Bank Transfer Payment MethodobjectRequired

Response

Stored payment method added successfully.

paymentMethodTokenstringOptional

Token representing the payment method.

typestringOptional

Type of the payment method.

identifierstringOptional

Identifier for the payment method (e.g., last 4 digits).

lastUseddatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

Timestamp of the last successful transaction.

createdAtdatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

Timestamp when the payment method was added.

1	curl -X POST https://api.payos.money/v1/payers/payerId/paymentMethods \
2	-H "Content-Type: application/json" \
3	-d '{
4	"type": "debitCard",
5	"encryptedPan": "encryptedPan",
6	"encryptedCvv": "encryptedCvv"
7	}'

1	{
2	"paymentMethodToken": "paymentMethodToken",
3	"type": "type",
4	"identifier": "identifier",
5	"lastUsed": "2024-01-15T09:30:00Z",
6	"createdAt": "2024-01-15T09:30:00Z"
7	}

Path parameters

Request

Response

Errors