PTP CorpAPI Documentation

OrderStatus

order.status

General order lifecycle status for card issue and topup operations.

From	To	Description
`new`	`activatingprocessingfailed`	Initial state after order creation
`activating`	`completedfailed`	Card activation in progress
`processing`	`completedfailed`	Order being processed
`completed`	terminal	Order successfully completed
`failed`	terminal	Order failed permanently

order.issue_status

Detailed status tracking for card issuance orders.

From	To	Description
`card_create_pending`	`card_create_donecard_create_error`	Waiting for card creation
`card_create_error`	`card_create_pendingcard_create_done`	Card creation failed, retry possible
`card_create_done`	`initial_topup_pendinginitial_topup_skipped`	Card created successfully
`initial_topup_skipped`	terminal	Initial topup skipped (free issue — user must top up manually to activate)
`initial_topup_pending`	`initial_topup_in_progressinitial_topup_error`	Waiting for initial topup
`initial_topup_error`	`initial_topup_pendinginitial_topup_in_progress`	Initial topup failed, retry possible
`initial_topup_in_progress`	`initial_topup_doneinitial_topup_error`	Initial topup processing
`initial_topup_done`	`completedinitial_topup_verify_error`	Initial topup completed
`initial_topup_verify_error`	`initial_topup_donecompleted`	Verification failed, retry possible
`completed`	terminal	Card issue completed successfully

order.topup_status

Status tracking for card topup operations.

From	To	Description
`new`	`provider_in_progressnew_errorfailed`	New topup order created
`new_error`	`newprovider_in_progressfailed`	Initial processing error, retry possible
`provider_in_progress`	`provider_verificationprovider_in_progress_errorcompletedfailed`	Provider processing topup
`provider_in_progress_error`	`provider_in_progressprovider_verificationfailed`	Provider error, retry possible
`provider_verification`	`completedprovider_verification_errorfailed`	Verifying with provider
`provider_verification_error`	`provider_verificationcompletedfailed`	Verification error, retry possible
`completed`	terminal	Topup completed successfully
`failed`	terminal	Topup failed permanently

card.status

Current operational status of a card.

From	To	Description
`pending_order`	`paidclosed`	Card record created, order not yet paid
`paid`	`pending_activationactiveclosed`	Order paid, card being provisioned
`pending_activation`	`activewait_for_topup_activation_by_userclosed`	Card provisioned, awaiting activation
`wait_for_topup_activation_by_user`	`activeclosed`	Free issue — card activates on first user top-up
`active`	`frozenclosed`	Card is active and usable
`frozen`	`activeclosed`	Card temporarily suspended
`closed`	terminal	Card permanently closed

cardholder.registration_status

Registration status of a cardholder with the provider.

From	To	Description
`pending`	`activefailed`	Registration in progress
`active`	`suspended`	Cardholder is active
`suspended`	`activefailed`	Cardholder suspended
`failed`	terminal	Registration failed permanently

transaction.transStatus

Provider transaction status returned in /cards/txs items and card_transaction webhooks.

From	To	Description
`PENDING`	`APPROVEDDECLINED`	Transaction awaiting authorization
`APPROVED`	terminal	Transaction approved by provider
`DECLINED`	terminal	Transaction declined by provider
`OTHER`	terminal	Other provider-specific status

transaction.transType

Type of card transaction from provider.

From	To	Description
`AUTH`	terminal	Authorization (purchase attempt)
`REVERSAL`	terminal	Reversal of a previous authorization
`FEE`	terminal	Fee charged by provider
`REFUND`	terminal	Refund to the card
`OTHER`	terminal	Other transaction type