Register Card

POST

***

Request Parameters

Name	Type	Description
`public_key`Required	`String`	Merchant identifier. Example: `i000000001`
`language`Required	`String`	Page display language. Values: `az`, `en`, `ru`
`refund`Optional	`Number`	Card type: `0` — payment card, `1` — payout card.
`description`Optional	`String`	Description. Max 1000 characters.
`success_redirect_url`Optional	`String`	Redirect URL on successful registration.
`error_redirect_url`Optional	`String`	Redirect URL on failed registration.

Request Example

Send Request

Payload

{
  "public_key": "i000000001",
  "language": "az"
}

1DATA=$(echo -n '{"public_key":"i000000001","language":"az"}' | base64)
2SIGNATURE=$(echo -n "$PRIVATE_KEY$DATA$PRIVATE_KEY" | openssl dgst -sha1 -binary | base64)
3
4curl -X POST *** \
5-H "Content-Type: application/x-www-form-urlencoded" \
6-d "data=$DATA&signature=$SIGNATURE"

Response Parameters

Name	Type	Description
`status`Required	`String`	Operation result: `success` or `failed`
`code`Optional	`String`	`000` — success, `500` — error
`message`Optional	`String`	Status message
`card_id`Optional	`String`	Unique card identifier for future payments
`bank_transaction`Optional	`String`	Bank transaction identifier
`bank_response`Optional	`String`	Bank response
`trace_id`Required	`String`	Unique request identifier for debugging. Provide this to Epoint support for issue investigation.

Success

Success Response
{
  "status": "success",
  "code": "000",
  "card_id": "card_abc123",
  "bank_transaction": "BT12345",
  "bank_response": "000",
  "trace_id": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"
}