Create gift card

To create a gift card, you can use the following endpoint:

POST https://[base_url]/v1/gift-cards

After creating the gift card, you must complete the payment process to activate the balance for the recipient

Body parameters

Field	Type	Required	Description
sender.name	string	Yes	Full name of the sender
sender.document_type	string	Yes	Type of ID (CC, PP, NIT, TI)
sender.document_number	string	Yes	Sender's identification number
sender.email	string	Yes	Sender's email address
sender.address	string	Yes	Sender's physical address
sender.phone	string	Yes	Sender's phone number
sender.country_code	string	Yes	Country calling code (e.g., +57)
recipient.name	string	Yes	Full name of recipient
recipient.email	string	Yes	Recipient's email address
amount	number	Yes	Gift card amount
currency	string	Yes	Currency code (e.g., COP, USD)
note	string	Yes	Note to show in the gift card
external_ref_id	string	Yes	External identification ID for future payment references
temp_webhook_url	string	Yes	Url of the webhook to which the payment notification will be sent by Autocore. It must be an endpoint that receives POST requests.
success_url	string	Yes	URL to redirect to after a successful transaction
failure_url	string	Yes	URL to redirect to after a failed transaction

Body example

{
    "sender": {
        "name": "Jhon Doe",
        "document_type": "CC",
        "document_number": "11113333",
        "email": "[email protected]",
        "address": "123 Main St",
        "phone": "5551234",
        "country_code": "+57"
    },
    "recipient": {
        "name": "Jane Doe",
        "email": "[email protected]"
    },
    "amount": 50000,
    "currency": "COP",
    "note":"Happy Birthday!",
    "external_ref_id": "id_345",
    "temp_webhook_url": "https://7099-181-204-153-195.ngrok-free.app/webhooks",
    "success_url": "https://app-dev.autocore.pro/",
    "failure_url": "https://app.autocore.pro/"
}

Endpoint response

Status code: 200

{
    "msg": "Tarjeta de regalo creada correctamente",
    "gift_card_code": "D32X693Q33",
    "payment_link": "https://app-dev.autocore.pro/payment/marina/GC_4uykdvkhgb",
    "payment_link_code": "GC_4uykdvkhgb"
}

Status code: 401, 403, 404

{
 "code": "Status code",
 "message":"Error description",
 "detail": "Error details"
}