curl --request POST \
--url https://api.malga.io/v1/cards \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--header 'X-Client-Id: <api-key>' \
--data '
{
"tokenId": "82aba896-9e37-45b6-aa90-d510c9050596",
"merchantId": "cc4945bc-85f4-495e-adc6-3b281c9d957a",
"cvvCheck": true
}
'const options = {
method: 'POST',
headers: {
'X-Client-Id': '<api-key>',
'X-Api-Key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
tokenId: '82aba896-9e37-45b6-aa90-d510c9050596',
merchantId: 'cc4945bc-85f4-495e-adc6-3b281c9d957a',
cvvCheck: true
})
};
fetch('https://api.malga.io/v1/cards', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.malga.io/v1/cards"
payload := strings.NewReader("{\n \"tokenId\": \"82aba896-9e37-45b6-aa90-d510c9050596\",\n \"merchantId\": \"cc4945bc-85f4-495e-adc6-3b281c9d957a\",\n \"cvvCheck\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Client-Id", "<api-key>")
req.Header.Add("X-Api-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"id": "148d5db0-f1c3-439f-902d-f1f268086e1d",
"status": "active",
"statusReason": null,
"createdAt": "2012-08-11T19:02:56.713Z",
"clientId": "cc0b1e41-2936-45c5-947f-93995ffcdc00",
"brand": "Visa",
"cardHolderName": "JOAO DA SILVA",
"cvvChecked": true,
"fingerprint": "cbd4a441-c63c-4dee-ac6b-bfa7fa1df818",
"first6digits": "401959",
"last4digits": "9339",
"customerId": "82aba896-9e37-45b6-aa90-d510c9050596",
"expirationMonth": "12",
"expirationYear": "2026",
"transactionRequests": [
{
"id": "edd0d86a-76d0-4c2c-b924-1528510a5a32",
"createdAt": "2023-09-25T18:09:59.001Z",
"providerId": "5ce68ed3-2213-423b-8eaf-9d8c4b40df2b",
"providerType": "SANDBOX",
"requestStatus": "success",
"requestType": "zero_dollar",
"responseTs": "32ms"
}
]
}{
"error": {
"type": "api_error",
"code": 123,
"declinedCode": "<string>",
"key": "<string>",
"businessCode": "<string>",
"message": "<string>",
"details": "<array>"
}
}{
"type": "failed_dependency",
"declinedCode": "<string>",
"message": "<string>",
"details": "<array>"
}{
"error": {
"type": "api_error",
"code": 123,
"declinedCode": "<string>",
"key": "<string>",
"businessCode": "<string>",
"message": "<string>",
"details": "<array>"
}
}Criar novo cartão a partir de token
curl --request POST \
--url https://api.malga.io/v1/cards \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--header 'X-Client-Id: <api-key>' \
--data '
{
"tokenId": "82aba896-9e37-45b6-aa90-d510c9050596",
"merchantId": "cc4945bc-85f4-495e-adc6-3b281c9d957a",
"cvvCheck": true
}
'const options = {
method: 'POST',
headers: {
'X-Client-Id': '<api-key>',
'X-Api-Key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
tokenId: '82aba896-9e37-45b6-aa90-d510c9050596',
merchantId: 'cc4945bc-85f4-495e-adc6-3b281c9d957a',
cvvCheck: true
})
};
fetch('https://api.malga.io/v1/cards', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.malga.io/v1/cards"
payload := strings.NewReader("{\n \"tokenId\": \"82aba896-9e37-45b6-aa90-d510c9050596\",\n \"merchantId\": \"cc4945bc-85f4-495e-adc6-3b281c9d957a\",\n \"cvvCheck\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Client-Id", "<api-key>")
req.Header.Add("X-Api-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"id": "148d5db0-f1c3-439f-902d-f1f268086e1d",
"status": "active",
"statusReason": null,
"createdAt": "2012-08-11T19:02:56.713Z",
"clientId": "cc0b1e41-2936-45c5-947f-93995ffcdc00",
"brand": "Visa",
"cardHolderName": "JOAO DA SILVA",
"cvvChecked": true,
"fingerprint": "cbd4a441-c63c-4dee-ac6b-bfa7fa1df818",
"first6digits": "401959",
"last4digits": "9339",
"customerId": "82aba896-9e37-45b6-aa90-d510c9050596",
"expirationMonth": "12",
"expirationYear": "2026",
"transactionRequests": [
{
"id": "edd0d86a-76d0-4c2c-b924-1528510a5a32",
"createdAt": "2023-09-25T18:09:59.001Z",
"providerId": "5ce68ed3-2213-423b-8eaf-9d8c4b40df2b",
"providerType": "SANDBOX",
"requestStatus": "success",
"requestType": "zero_dollar",
"responseTs": "32ms"
}
]
}{
"error": {
"type": "api_error",
"code": 123,
"declinedCode": "<string>",
"key": "<string>",
"businessCode": "<string>",
"message": "<string>",
"details": "<array>"
}
}{
"type": "failed_dependency",
"declinedCode": "<string>",
"message": "<string>",
"details": "<array>"
}{
"error": {
"type": "api_error",
"code": 123,
"declinedCode": "<string>",
"key": "<string>",
"businessCode": "<string>",
"message": "<string>",
"details": "<array>"
}
}Body
Create credit card
Identificador do token gerado
Caso queria validar o cartão via zero dollar, informe o merchantId que possui pelo menos 1 provedor com suporte a validação zero dollar.
Mesmo informando o merchantId, é possível desabilitar a validação do cvv (zero dollar). Informe true para validar ou false para pular a validação. Caso você informe false, a verificação será pulada e o cartão será criado como pending necessitando validar via uma transação.
Response
Created
ID do cartão
Status de validação dos dados cartões, failed (cartão inválido para uso), active (cartão válido para uso), pending (validação do cartão pendente, uso autorizado temporariamente)
failed, active, pending Contém uma string com um breve descritivo informando o motivo do status do cartão. Em alguns casos uma string vazia é retornada.
Data de criação do cartão
Identificação do cliente
Bandeira do cartão
American Express, Mastercard, Visa, Elo, Discover, JCB, Diners Nome do cliente do cartão
Identifica se o CVV foi verificado
Hash de identificação única do cartão com base nos dados sensíveis
Primeiros 6 digitos do cartão
Últimos 4 digitos do cartão
Identificador de comprador na Malga para consulta futura - Integração com a API de customer
Data de expiração MM
Data de expiração YYYY
Lista de tokens externos associados ao cartão
Show child attributes
Show child attributes
Related topics
Autentique-se com a MalgaCartão de créditoComeçando em meios de pagamentoPagamentos com Pix na MalgaWas this page helpful?