This API call retrieves all the details associated with the client session corresponding to the client token that is provided in the request. The fields with empty values are excluded from the response.


Client token corresponding to the client session to retrieve

Retrieve a client session

Create a client session

Update client session

Client Session API

Filter payments by their payment method type.

Filter payments by their payment processor.

Return only payments from this date (inclusive).

Return only payments up to this date (inclusive).

Return payments related to this order ID.

Return payments of this amount minimum (inclusive).

Return payments of this amount max (inclusive).

ID of the customer that has made the payment.

ID of the merchant involved in the payment.

Email of the customer that has made the payment.

Last 4 digits of the card used for the payment.

Paypal email address associated with the payment.

Klarna email address associated with the payment.

Maximum number of payments to return per page.

Search & list payments

Create a payment

Authorize a payment

Capture a payment

Cancel a payment

Refund a payment

Resume a payment

ID of payment for adjusting authorization.

Adjust authorized amount

Get a payment

Payments API

Save a payment method token

Retrieve a list of stored payment methods for a customer.

Return payment methods for this customer ID.

List saved payment methods

Delete a saved payment method

Update a saved payment method to be the default stored payment method for a customer.

Saved payment method token to set to default.

Update the default saved payment method

Payment Methods API

Create an external payment

Update an external payment

Observability API

The unique identifier for the customer on the loyalty provider.

ID of the Primer connection configuration.

Get a loyalty customer's points balance

The number of items to skip before returning results

List the transactions for a customer

Create a loyalty transaction

Loyalty API

AccountFundingTypeEnum

AddressApiSchema

Name of the city, district, town or village

ApayaCustomerTokenApiSchema

AuthorizationTypeEnum

BadRequestErrorResponse

BinDataApiSchema

BlockingPaymentActionTypeEnum

CardAccountNumberTypeEnum

CardNetworkEnum

CardProductTypeEnum

CardRegionRestrictionEnum

CheckoutCustomerDetailsApiSchema

The customer's tax id number for tax exemptions

The customer's national identification number

CheckoutPaymentMethodCardOptionApiSchema

Dictionary of available card networks as a key with value of Payment Method Card Network Option.

CheckoutPaymentMethodOptionApiSchema

CheckoutPaymentMethodOptionCardNetworkApiSchema

CheckoutPaymentMethodOptionCardNetworkSurchargeApiSchema

CheckoutPaymentMethodOptionSurchargeApiSchema

The surcharge amount, in minor units. Surcharge amount must be used in conjunction with line item amounts, if a top level amount is passed then surcharge will not be calculated.

CheckoutPaymentMethodOptionsApiSchema

Whether the payment method should be vaulted on a successful payment or not.

Whether the payment method should be vaulted after a successful 3DS authentication or not.

A description of the payment, as it would typically appear on a bank statement.

CheckoutPaymentMethodOptionsApiSchemaOptions

ClientSessionApiResponse

Additional data to be used throughout the payment lifecycle.


More information associated with the customer.

More information associated with the order.

Enable certain options associated with the payment methods.

ClientSessionWarningsApiResponse

A unique code describing the particular issue

More information as to the reason for the warning

ClientSessionWithTokenApiResponse

Client token used to initialize the SDK on all platforms.

Expiration date & time of the client token (UTC with no timezoneinfo).

Warning messages to indicate missing information that are required for payment methods, checkout modules and other features; or when third-party services are unavailable.

ConflictErrorResponse

CountryCodeEnum

Currency

CustomerDetailsApiSchema

DeclineTypeEnum

An object containing information about the error that occurred.

ErrorObject

A human readable description of the error

An ID that you can quote when contacting the support team (support@primer.io).

Returned in case of a badly formed request

Results of the pre-authorization and post-authorization fraud checks.


FraudCheckApiSchema

FraudDecisionTypeEnum

GoCardlessMandateApiSchema

Unique identifier of a GoCardless mandate agreement

IdealPayNlTokenApiSchema

KlarnaAddressApiSchema

KlarnaCustomerTokenApiSchema

KlarnaPaymentSessionApiSchema

KlarnaSessionDetailsApiSchema

KlarnaTokenDetails

LoyaltyApiBalanceResponse

LoyaltyApiTransactionResponse

Creation date & time of the transaction (UTC)

Unique Primer identifier for the loyalty transaction.

ID of the transaction on the loyalty provider's side.

LoyaltyApiTransactionsListResponse

LoyaltyTransactionTypeEnum

MerchantPaymentMethodTokenApiResponse

Date & time when this object was revoked. (UTC)

Whether or not this object has been revoked.

Unique analytics identifier corresponding to a payment method

Payment method type associated with a token.

Whether or not this payment method is the default

MerchantPaymentMethodTokenApiResponsePaymentMethodData

NotFoundErrorResponse

OptionalAddressApiSchema

OrderDetailsApiSchema

The details of the line items of the order.

The country in which the order is created

OrderFeesApiSchema

A description of the fee, e.g. "Currency Conversion Fee".

OrderLineItemsApiSchema

The amount charged to the customer, in minor units. The minimum amount is 0.

The number of the particular line item that is being ordered.

The tax code associated with this item, in minor units. This is required for Primer-initiated tax calculations.

OrderLineItemsProductDataApiSchema

The product Global Trade Item Number (e.g. ISBN)

OrderShippingApiSchema

PayPalBillingAgreementApiSchema

PayPalExternalPayerInfoApiSchema

PayPalOrderTokenApiSchema

PaymentApiResponse

The date and time at which the payment was created in UTC format.

The amount you charged the customer, in minor units.

The payment method options provided in the request, as well as the token used to process the payment.

More information associated with the payment processor, including the processor name.

Required action to perform in order to resume the payment workflow. This can be requiring a 3DS check from the customer for instance.

PaymentAuthorizationRequestProcessorApiSchema

The processor's merchant ID used to authorize the payment.

The processor name should be provided if the processorMerchantId is not unique across all of your integrations.

PaymentCaptureApiRequestOrder

The country code of the retailer.
This field is passed to the processor and overwrites the retailer country code set in order details.

PaymentCardTokenApiSchema

PaymentListApiResponse

PaymentMethodTypeEnum

PaymentRequestPaymentMethodOptionsApiSchema

PaymentRequiredActionApiSchema

Human description of the required action to perform.

The client token to be returned to the SDK if a required action is returned.

PaymentResponsePaymentMethodOptionsApiSchema

The description of the payment, as it would typically appear
on a bank statement.


The payment method token used to authorize the transaction.

Whether the payment method token represents a vaulted payment method and can be used for future payments.

Payment method type used for payment authorization.

PaymentResponsePaymentMethodOptionsApiSchemaPaymentMethodData

PaymentResponseProcessorApiSchema

The payment processor used for this payment.

The merchant ID registered at the payment processor used for this payment.

PaymentStatus

PaymentStatusTypeEnum

PaymentSummaryApiSchema

PaymentSummaryProcessorApiSchema

PaymentsInsightsBinData

The usage type of the payment card e.g. commercial, consumer.

The funding type of the payment card e.g. credit, debit, prepaid.

PaymentsInsightsBinDataIssuerCountryCode

PaymentsInsightsOrder

PaymentsInsightsOrderCountryCode

PaymentsInsightsPatchedPaymentCurrencyCode

PaymentsInsightsPatchedPaymentPaymentType

PaymentsInsightsPatchedPaymentStatus

PaymentsInsightsPayment

A description of the payment,
as it would typically appear on a bank statement.

PaymentsInsightsPaymentCurrencyCode

PaymentsInsightsPaymentMethod

PaymentsInsightsPaymentMethodData

The first six digits of the card used for payment,
also known as the Bank Identification Number (BIN).

PaymentsInsightsPaymentPaymentType

PaymentsInsightsPaymentStatus

PaymentsInsightsProcessor

The payment processor used for this payment.
Primer supports the above processors through the Payments API,
however any value can be passed here.

PaymentsInsightsProcessorName

PaymentsInsightsStatusReason

Payment status code with the error code when
the issuer declined the payment.

Message detail returned by the processor when
the error on appeared on their part.

PaymentsInsightsStatusReasonCode

PaymentsInsightsStatusReasonDeclineType

PaymentsInsightsStatusReasonType

PaymentsInsightsThreeDSecureAuthentication

The response returned during the 3D Secure authentication call.

The challenge status of the 3D Secure authentication.
Set to false for frictionless 3D Secure authentication.

Update the default saved payment method

Path parameters

Response

Errors

1	curl -X POST https://api.primer.io/payment-instruments/payment-method-token/default \
2	-H "X-API-KEY: <apiKey>"

1	{
2	"paymentMethodType": "PAYMENT_CARD"
3	}