카드 등록 링크 생성
curl --request POST \
--url https://meterengine.com/v1/customers/{id}/payment-method-registrations \
--header 'Authorization: Bearer <token>'const url = 'https://meterengine.com/v1/customers/{id}/payment-method-registrations';
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"client_key": "<string>",
"customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"customer_key": "<string>",
"customer_name": "<string>",
"expires_at": "2023-11-07T05:31:56Z",
"mode": "test",
"organization_name": "<string>",
"token": "<string>"
}{
"code": "validation_error",
"message": "서버 내부 오류입니다",
"errors": [
{
"field": "event_type",
"message": "공백일 수 없습니다"
}
]
}{
"code": "validation_error",
"message": "서버 내부 오류입니다",
"errors": [
{
"field": "event_type",
"message": "공백일 수 없습니다"
}
]
}{
"code": "validation_error",
"message": "서버 내부 오류입니다",
"errors": [
{
"field": "event_type",
"message": "공백일 수 없습니다"
}
]
}{
"code": "validation_error",
"message": "서버 내부 오류입니다",
"errors": [
{
"field": "event_type",
"message": "공백일 수 없습니다"
}
]
}{
"code": "validation_error",
"message": "서버 내부 오류입니다",
"errors": [
{
"field": "event_type",
"message": "공백일 수 없습니다"
}
]
}{
"code": "validation_error",
"message": "서버 내부 오류입니다",
"errors": [
{
"field": "event_type",
"message": "공백일 수 없습니다"
}
]
}카드 등록 링크
카드 등록 링크 생성
고객이 카드를 등록할 일회용 링크를 만든다. 본문은 받지 않는다. token은 이 응답에만 실린다. 서버는 token 원문을 저장하지 않으므로 다시 조회할 수 없다. 링크는 지금 결제 모드로 만들고 24시간 뒤 만료된다. 카드 등록에 한 번 쓰면 다시 쓸 수 없다. API 키로 부르면 키의 모드가 지금 결제 모드와 같아야 하고, 다르면 409다. expires_at은 KST(+09:00)로 나온다.
POST
/
v1
/
customers
/
{id}
/
payment-method-registrations
카드 등록 링크 생성
curl --request POST \
--url https://meterengine.com/v1/customers/{id}/payment-method-registrations \
--header 'Authorization: Bearer <token>'const url = 'https://meterengine.com/v1/customers/{id}/payment-method-registrations';
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"client_key": "<string>",
"customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"customer_key": "<string>",
"customer_name": "<string>",
"expires_at": "2023-11-07T05:31:56Z",
"mode": "test",
"organization_name": "<string>",
"token": "<string>"
}{
"code": "validation_error",
"message": "서버 내부 오류입니다",
"errors": [
{
"field": "event_type",
"message": "공백일 수 없습니다"
}
]
}{
"code": "validation_error",
"message": "서버 내부 오류입니다",
"errors": [
{
"field": "event_type",
"message": "공백일 수 없습니다"
}
]
}{
"code": "validation_error",
"message": "서버 내부 오류입니다",
"errors": [
{
"field": "event_type",
"message": "공백일 수 없습니다"
}
]
}{
"code": "validation_error",
"message": "서버 내부 오류입니다",
"errors": [
{
"field": "event_type",
"message": "공백일 수 없습니다"
}
]
}{
"code": "validation_error",
"message": "서버 내부 오류입니다",
"errors": [
{
"field": "event_type",
"message": "공백일 수 없습니다"
}
]
}{
"code": "validation_error",
"message": "서버 내부 오류입니다",
"errors": [
{
"field": "event_type",
"message": "공백일 수 없습니다"
}
]
}인증
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
경로 매개변수
카드를 등록할 고객의 id.
응답
만든 카드 등록 링크
토스페이먼츠 SDK에 넣을 클라이언트 키
토스페이먼츠 SDK에 넣을 customerKey. 고객 id와 같다
링크가 만료되는 시각. 만든 때부터 24시간 뒤다
링크를 만들 때의 결제 모드. test 또는 live
사용 가능한 옵션:
test, live 카드 등록 페이지 주소에 넣을 일회용 토큰. 링크를 만든 응답에만 싣고 공개 조회에는 싣지 않는다